blender-mcp
Discover how the Blender MCP addon executes commands on Blender's main thread using bpy app timers for safe API access. Learn about its background TCP server and thread management.
Security Considerations for execute_blender_code in Blender MCPLearn about execute_blender_code security considerations for Blender MCP. Understand the risks of executing arbitrary Python code and how to implement sandboxing and controls.
How the Blender MCP Server Uses FastMCP and Manages Async OperationsDiscover how the Blender MCP server uses FastMCP's asyncio framework to make synchronous Blender operations async-capable. Learn about thread-pool executors and non-blocking execution.
How to Configure BLENDER_HOST and BLENDER_PORT Environment Variables in Blender-MCPConfigure BLENDER_HOST and BLENDER_PORT environment variables for Blender-MCP. Learn how these settings direct connections to your Blender instance and their default values for seamless integration.
How Multiple 3D Asset Integrations Coexist and Report Status in Blender MCPLearn how Blender MCP enables multiple 3D asset integrations like Poly Haven and Sketchfab to coexist and report status through dynamic command handlers and scene flags.
How `get_blender_connection()` Implements Connection Pooling in Blender MCPDiscover how get_blender_connection() in Blender MCP implements connection pooling. Learn about its global instance, lightweight ping validation, and automatic socket recreation for efficient connections.
How Blender MCP Registers and Decorates Tools with the Telemetry DecoratorLearn how Blender MCP registers and decorates tools with the telemetry_decorator. Discover automatic metric capture for tool execution in src/blender_mcp/server.py.
Error Handling Strategies for Connection Errors and JSON Decode Failures in Blender-MCPLearn Blender MCP error handling strategies for connection errors and JSON decode failures. Discover how Blender MCP ensures stable communication through multi-layered resilience.
How the Blender MCP Addon Handles Client Connections in Separate ThreadsLearn how the Blender MCP addon uses separate threads for client connections ensuring thread safety with bpy app timers. Discover its multi-threaded TCP socket server.
How execute_blender_code Executes Arbitrary Python in Blender: Architecture Deep DiveDiscover how execute_blender_code runs arbitrary Python in Blender. Learn its architecture, from TCP sockets to isolated execution with exec() and stdout capture.
How the Blender MCP Viewport Screenshot Capture Tool Encodes and Returns ImagesDiscover how the Blender MCP viewport screenshot tool encodes and returns images by creating temporary PNGs, writing screenshots, and returning data within an Image object.
How Hunyuan3D Generation Differs from Hyper3D in the Blender MCP IntegrationExplore Hunyuan3D vs Hyper3D in Blender MCP integration. Understand their distinct backend commands, parameter structures, and result formats for efficient 3D generation.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →