MCP Link Blender

🚀 MCP-Link for Blender

Transform Blender into an AI-Controllable 3D Creation Platform

MCP-Link for Blender exposes Blender's entire Python API to AI agents through the Model Context Protocol (MCP). It offers pure, generic API access without hardcoded commands, enabling AI to perform any task that Blender can do.

🚀 Quick Start

What Makes This Revolutionary

Unlike traditional add - ons, MCP - Link provides infrastructure. It serves as a bridge that allows any AI agent, such as ChatGPT, Claude, Cursor, or custom agents, to control Blender via natural language.

Three Levels of Power

1. Python Execution: Run arbitrary Python code in Blender's runtime with full bpy access.
2. Direct API Calls: Execute any Blender operator or access any data.
3. MCP Tool Integration: Access 10+ tools (SQLite, browser, AI models, etc.).

✨ Features

• ✅ 100% Generic API: Works with ANY Blender command.
• ✅ Full Python Access: Run arbitrary Python code with complete bpy access.
• ✅ Persistent Sessions: Variables persist across multiple AI commands.
• ✅ MCP Tool Ecosystem: SQLite, browser automation, system control, and more.
• ✅ Auto - Connect: The extension connects to the MCP - Link server on startup.
• ✅ Auto - Reconnect: Handles connection drops gracefully.
• ✅ Thread - Safe: Ensures proper main - thread execution for Blender API calls.

📦 Installation

Method 1: From Blender Extensions

1. Open Blender.
2. Go to Edit → Preferences → Get Extensions.
3. Search for "MCP - Link".
4. Click Install.

Method 2: From ZIP File

1. Download mcp_link_blender-x.x.x.zip from releases.
2. Open Blender.
3. Go to Edit → Preferences → Add - ons.
4. Click Install from Disk....
5. Select the ZIP file.

Method 3: Command Line

blender --command extension install-file -r user_default -e mcp_link_blender-1.0.0.zip

💻 Usage Examples

Basic Usage

Create a 3D Cube

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.ops.mesh.primitive_cube_add(size=2, location=(0, 0, 1))\nprint(f'Created: {bpy.context.active_object.name}')"
}

Create a Complete Scene

{
  "operation": "execute_python",
  "code": "import bpy\n\n# Clear scene\nbpy.ops.object.select_all(action='SELECT')\nbpy.ops.object.delete()\n\n# Add ground plane\nbpy.ops.mesh.primitive_plane_add(size=10)\n\n# Add a sphere\nbpy.ops.mesh.primitive_uv_sphere_add(radius=1, location=(0, 0, 1))\nsphere = bpy.context.active_object\n\n# Add material\nmat = bpy.data.materials.new('Red')\nmat.diffuse_color = (1, 0, 0, 1)\nsphere.data.materials.append(mat)\n\nprint('Scene created!')"
}

Render to File

{
  "operation": "execute_python",
  "code": "import bpy\nbpy.context.scene.render.filepath = '/tmp/render.png'\nbpy.ops.render.render(write_still=True)\nprint('Rendered!')"
}

Building from Source

# Clone the repository
git clone https://github.com/AuraFriday/mcp_link_blender.git
cd MCP-Link-Blender

# Build the extension
make build

# Install to Blender
make install

Makefile Commands

🔧 Technical Details

1. Extension loads when Blender starts.
2. Auto - connects to the local MCP - Link server via SSE.
3. Registers "blender" as a remote tool.
4. Listens for commands from AI agents.
5. Executes on main thread via bpy.app.timers for thread safety.
6. Returns results to the AI agent.

Privacy & Security

• ✅ 100% Local: All processing happens on your machine.
• ✅ No Cloud Dependencies: Works completely offline.
• ✅ No Data Collection: Your designs never leave your computer.
• ✅ Open Source: Full transparency, auditable code.
• ✅ GPL - 3.0 License: Free as in freedom.

Troubleshooting

Extension not connecting

1. Make sure MCP - Link server is running.
2. Check Blender's System Console for error messages.
3. Verify the server is listening on the expected port.

Commands not executing

1. Ensure Blender is in Object Mode for most operations.
2. Check that required objects exist before manipulating them.
3. Review the error message in the response.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

📄 License

GPL - 3.0 - or - later. See LICENSE for details.

Credits

Created by Aura Friday - Trusted by 15,000+ users of previous add - ins.

Links:

• MCP - Link Server Download
• GitHub Repository
• Issue Tracker