ahujasid/mcp-for-blender

Project overview

It provides a two-component bridge between an MCP client and Blender, combining scene control, code execution, export, API lookup, and multiple third-party asset sources.

Project type

MCP · AI Agent

Use cases

Automation

Deployment

Refer to project documentation

License

MIT

Best for

• Blender creators and developers who need MCP-mediated inspection, scene manipulation, Blender Python execution, or GLB/FBX export.
• Teams that can operate a Blender addon and separate Python MCP server, configure an MCP client, and manage the security implications of a local socket.

Key capabilities

• Retrieves information about the current Blender scene and its objects for an MCP client.
• Creates and applies materials to Blender objects.
• Executes Python code inside Blender; an optional safe mode validates scripts and blocks selected risky operations.
• Exports a full scene, the current selection, or named objects to GLB or FBX for use in other applications.
• Looks up node schemas and Blender Python API references instead of relying on guessed socket order or enum names.
• Allows separate MCP client entries to address multiple Blender instances through distinct ports.

Limitations and risks

• Complex operations may need to be divided into smaller steps.
• The quickstart warns against running Cursor and Claude Desktop MCP server instances simultaneously for the same setup.
• On Linux, the documented Docker route requires host networking because host.docker.internal is unavailable and the addon listens only on localhost.
• Poly Pizza downloads can fail when its CDN blocks datacenter, VPN, or cloud IP addresses.
• The execute_blender_code tool can run arbitrary Python in Blender and may be dangerous in production environments; the optional safe mode validates scripts and blocks selected file, process, network, and persistence-related operations.
• Anyone able to reach the addon socket's port can run Python inside Blender, so direct exposure to an untrusted network is unsuitable.
• Anonymous usage telemetry is enabled by default and may be used for research and training AI models unless disabled.
• Many Poly Pizza assets require creator attribution, creating a licensing-compliance obligation for users who import them.

Getting started

• Install uv, point an MCP client at the mcp-for-blender server, install and enable the Blender addon, then open the MCP for Blender sidebar tab and start the MCP server.
• The documented quickstart requires Blender 3.0 or newer, Python 3.10 or newer, uv, an MCP client, the shipped Blender addon, and addon-server configuration.

Evidence and sources

• GitHub project description: Community plugin to control Blender 3D with any LLM of your choice
• README: The system consists of two main components: 1. **Blender Addon** (`addon.py`) — a Blender addon that creates a socket server within Blender to receive and execute commands 2. **MC…
• README: - Get scene and object information - Create, delete and modify shapes - Apply or create materials for objects - Execute any Python code in Blender - Export the scene, the selectio…
• README: Three steps: install `uv`, point your MCP client at the server, install the Blender addon.
• README: **3. Install the Blender addon** ```bash uvx mcp-for-blender install-addon ``` Then in Blender: **Edit → Preferences → Add-ons** → enable **Interface: MCP for Blender**. **4. Conn…

Source updated at: 2026-09-16T18:06:24Z

Open original GitHub project