# blender-mcp | ahujasid | Knowledge Base | Instagit

GitHub Stars: 19.3k

Repository: https://github.com/ahujasid/blender-mcp

---

## Articles

### [How the Blender MCP Addon Executes Commands on Blender's Main Thread](/ahujasid/blender-mcp/blender-addon-execute-commands-main-thread)

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.

- Tags: internals
- Published: 2026-04-13

### [Security Considerations for execute_blender_code in Blender MCP](/ahujasid/blender-mcp/security-considerations-execute-blender-code-tool)

Learn about execute_blender_code security considerations for Blender MCP. Understand the risks of executing arbitrary Python code and how to implement sandboxing and controls.

- Tags: best-practices
- Published: 2026-04-13

### [How the Blender MCP Server Uses FastMCP and Manages Async Operations](/ahujasid/blender-mcp/server-fastmcp-async-operations-management)

Discover 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.

- Tags: internals
- Published: 2026-04-13

### [How to Configure BLENDER_HOST and BLENDER_PORT Environment Variables in Blender-MCP](/ahujasid/blender-mcp/server-configuration-blender-host-port)

Configure 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.

- Tags: how-to-guide
- Published: 2026-04-13

### [How Multiple 3D Asset Integrations Coexist and Report Status in Blender MCP](/ahujasid/blender-mcp/multiple-3d-asset-integrations-coexistence-status)

Learn 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.

- Tags: internals
- Published: 2026-04-13

### [How `get_blender_connection()` Implements Connection Pooling in Blender MCP](/ahujasid/blender-mcp/get-blender-connection-function-connection-pooling)

Discover 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.

- Tags: internals
- Published: 2026-04-13

### [How Blender MCP Registers and Decorates Tools with the Telemetry Decorator](/ahujasid/blender-mcp/mcp-tools-registration-telemetry-decorator)

Learn how Blender MCP registers and decorates tools with the telemetry_decorator. Discover automatic metric capture for tool execution in src/blender_mcp/server.py.

- Tags: internals
- Published: 2026-04-13

### [Error Handling Strategies for Connection Errors and JSON Decode Failures in Blender-MCP](/ahujasid/blender-mcp/error-handling-connection-json-decode-failures)

Learn Blender MCP error handling strategies for connection errors and JSON decode failures. Discover how Blender MCP ensures stable communication through multi-layered resilience.

- Tags: exception-handling
- Published: 2026-04-13

### [How the Blender MCP Addon Handles Client Connections in Separate Threads](/ahujasid/blender-mcp/blender-addon-client-connections-separate-threads)

Learn 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.

- Tags: internals
- Published: 2026-04-13

### [How execute_blender_code Executes Arbitrary Python in Blender: Architecture Deep Dive](/ahujasid/blender-mcp/execute-blender-code-tool-arbitrary-python)

Discover how execute_blender_code runs arbitrary Python in Blender. Learn its architecture, from TCP sockets to isolated execution with exec() and stdout capture.

- Tags: architecture
- Published: 2026-04-13

### [How the Blender MCP Viewport Screenshot Capture Tool Encodes and Returns Images](/ahujasid/blender-mcp/viewport-screenshot-tool-encoding-images)

Discover how the Blender MCP viewport screenshot tool encodes and returns images by creating temporary PNGs, writing screenshots, and returning data within an Image object.

- Tags: internals
- Published: 2026-04-13

### [How Hunyuan3D Generation Differs from Hyper3D in the Blender MCP Integration](/ahujasid/blender-mcp/hunyuan3d-vs-hyper3d-integration)

Explore Hunyuan3D vs Hyper3D in Blender MCP integration. Understand their distinct backend commands, parameter structures, and result formats for efficient 3D generation.

- Tags: deep-dive
- Published: 2026-04-13

### [How Hyper3D Rodin Model Generation Works in Blender-MCP: Text-to-3D and Image-to-3D Pipelines Explained](/ahujasid/blender-mcp/hyper3d-rodin-model-generation-tools)

Discover how Blender-MCP's Hyper3D Rodin generates 3D models from text and images. Learn about the text-to-3D and image-to-3D pipelines and their RPC calls for seamless model creation.

- Tags: deep-dive
- Published: 2026-04-13

### [How Sketchfab Model Search and Download Works in Blender MCP](/ahujasid/blender-mcp/sketchfab-model-search-download-process)

Discover how Blender MCP integrates Sketchfab model search and download. Learn how queries are routed through an MCP server for authentication, GLTF asset download, and seamless Blender import.

- Tags: how-to-guide
- Published: 2026-04-13

### [How the Poly Haven Integration Fetches and Imports Assets into Blender](/ahujasid/blender-mcp/poly-haven-integration-fetch-import-assets)

Learn how the Poly Haven integration fetches and imports assets into Blender. Discover how Python queries the API, downloads assets, and integrates them seamlessly using the bpy API.

- Tags: how-to-guide
- Published: 2026-04-13

### [How to Disable Blender-MCP Telemetry Using Environment Variables](/ahujasid/blender-mcp/disable-telemetry-environment-variables)

Easily disable Blender-MCP telemetry by setting environment variables. Learn which variables to use and how to set them for complete privacy.

- Tags: how-to-guide
- Published: 2026-04-13

### [What Telemetry Data Blender MCP Collects and How User Consent Controls It](/ahujasid/blender-mcp/telemetry-data-collected-user-consent)

Discover what Blender MCP telemetry data is collected and how user consent controls it. Learn about anonymous usage events and sensitive data transmission.

- Tags: internals
- Published: 2026-04-13

### [How the receive_full_response Method Handles Chunked Responses from Blender](/ahujasid/blender-mcp/receive-full-response-method-chunked-responses)

Learn how receive_full_response handles chunked Blender responses by buffering TCP socket data and parsing JSON to detect completion. Optimize your Blender API integration.

- Tags: internals
- Published: 2026-04-13

### [How the Blender MCP Server Handles Socket Timeouts (180‑Second Configuration)](/ahujasid/blender-mcp/server-socket-timeout-handling-180s)

Discover how the Blender MCP server manages 180-second socket timeouts, invalidating connections and raising Python exceptions for unresponsive add-ons. Optimize your Blender workflow.

- Tags: internals
- Published: 2026-04-13

### [What Happens During Server Startup and Shutdown in the Lifespan Handler](/ahujasid/blender-mcp/server-startup-shutdown-lifespan-handler)

Understand the server startup and shutdown process within the lifespan handler. Learn how FastAPI initialization, telemetry startup, and resource cleanup are orchestrated during the server's lifecycle.

- Tags: internals
- Published: 2026-04-13

### [How the BlenderConnection Class Manages Connection Lifecycle and Reconnection in blender-mcp](/ahujasid/blender-mcp/how-blenderconnection-class-manages-connection)

Discover how the BlenderConnection class in blender-mcp manages connection lifecycle and automatic reconnection using a dual-layer validation strategy for robust error handling.

- Tags: internals
- Published: 2026-04-13

### [Blender MCP JSON Protocol Format: Complete Guide to Commands and Responses](/ahujasid/blender-mcp/json-protocol-format-commands-responses)

Master the Blender MCP JSON protocol. Learn request and response formats for seamless command execution and data retrieval.  Explore TCP socket communication for your projects.

- Tags: api-reference
- Published: 2026-04-13

### [How TCP Socket Communication Works Between the Blender MCP Server and Blender Addon](/ahujasid/blender-mcp/how-tcp-socket-communication-works-blender-mcp-server-addon)

Learn how TCP socket communication connects the Blender MCP server and addon. Discover how the addon acts as a server for remote LLM-driven Blender command execution via JSON.

- Tags: internals
- Published: 2026-04-13