blender-mcp-server

# Blender MCP Server Control Blender from any AI assistant using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io). 27 tools across 7 namespaces — create objects, assign materials, render images, export scenes, execute Python scripts, manage async jobs, and more.  ## How It Works ``` ┌─────────────┐ stdio ┌──────────────────┐ JSON/TCP ┌─────────────────┐ │ MCP Client │ ◄──────────────► │ MCP Server │ ◄─────────────► │ Blender Add-on │ │ (any host) │ │ (Python) │ localhost:9876 │ (runs in bpy) │ └─────────────┘ └──────────────────┘ └─────────────────┘ ``` 1. The **Blender add-on** runs inside Blender and listens on `localhost:9876`. 2. The **MCP server** connects to your AI client via stdio and forwards tool calls to Blender over TCP. 3. You ask the AI → it calls MCP tools → Blender executes commands → results flow back. ## Quick Start ### 1. Install the MCP Server ```bash git clone https://github.com/djeada/blender-mcp-server.git cd blender-mcp-server python3 -m venv .venv source .venv/bin/activate pip install -e . ``` This creates the executable `.venv/bin/blender-mcp-server`. ### 2. Install the Blender Add-on Build the add-on zip: ```bash ./scripts/build_addon_zip.sh ``` Then in Blender: 1. Go to **Edit → Preferences → Add-ons → Install**. 2. Select `dist/blender_mcp_bridge.zip` and enable **Blender MCP Bridge**. 3. In the 3D Viewport, press **N** → open the **MCP** tab. 4. Confirm it shows **Listening on 127.0.0.1:9876**. ### 3. Connect Your MCP Client <details> <summary><strong>Claude Desktop</strong></summary> Add to your config file: | OS | Path | |---|---| | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` | | Windows | `%APPDATA%\Claude\claude_desktop_config.json` | | Linux | `~/.config/Claude/claude_desktop_config.json` | ```…