blender-mcp-bridge

# Tool List ## Overview ### Development Motivation As of June 2026, the [official Blender MCP add-on](https://lab.blender.org/mcp) appears to use a proprietary TCP protocol (`{"type": "execute", "code": "..."}`) and does not implement the standard MCP (JSON-RPC 2.0). Since Claude Desktop only works with standard MCP, this bridge was created. ### Goals To enable direct control of Blender from standard MCP clients (Claude Desktop / Claude Code / Gemini CLI, etc.). ### Capabilities With instructions from AI agents like Claude Code, you can perform scene operations in Blender (object creation, transformation, material setting). ``` Claude Desktop / Claude Code │ stdio (MCP JSON-RPC 2.0) ← Claude can speak in this format ▼ blender-mcp-bridge ← This app (conversion and transfer) │ TCP socket (port 9876) ← Format accepted by Blender add-on ▼ Blender Add-on ``` ## Operating Environment ### Prerequisites - Python 3.10 or higher - [Official Blender MCP add-on](https://lab.blender.org/mcp) (needs to be installed and enabled on the Blender side) ### Supported Platforms macOS / Windows ## Quick Start ### Install directly from GitHub using Claude Code (recommended) ```bash claude mcp add blender-mcp-bridge \ --env BLENDER_HOST=localhost \ --env BLENDER_PORT=9876 \ -- uvx --from git+https://github.com/otinori/blender-mcp-bridge blender-mcp-bridge ``` `uvx` will fetch and execute the repository directly, so cloning and `pip install` are not necessary. ### Register using the setup script ```bash # Clone and then execute git clone https://github.com/otinori/blender-mcp-bridge cd blender-mcp-bridge python3 scripts/setup.py # Install MCP library and register in configuration file ``` For individual client settings: ```bash python3 scripts/setup_claude_desktop.py # Claude Desktop python3 scripts/setup_claude_code.py # Claude Code (CLI) python3 scripts/setup_gemini.py # Gemini CLI python3 scripts/setup_vscode.py # VS Code (all MCP-enabled extensions) python3 scripts/setup_codex.py # OpenAI Codex CLI ``` ※ Note: The author does not have access to the environment, so the vscode and codex versions have not been verified. ## Main Usage 1. **Install and enable the Blender MCP add-on**. 2. **Launch Blender** (the add-on starts listening on port 9876). 3. **Restart Claude Desktop or Claude Code**. 4. Ask Claude to "tell me about the Blender scene" or similar. Change the connection destination (host/port) using the `BLENDER_HOST` / `BLENDER_PORT` environment variables. The default is `localhost:9876`. ### Tool List | Tool Name | Description | |---|---| | `blender_get_scene_info` | Returns the name, number of objects, and frame information of the active scene. | | `blender_list_objects` | Lists objects in the scene (filterable by `type`). | | `blender_get_object` | Returns the position, rotation, scale, and material of a specified object. | | `blender_create_object` | Creates a mesh, light, camera, etc. | | `blender_delete_object` | Deletes a specified object. | | `blender_transform_object` | Changes position, rotation, and scale (partial updates possible). | | `blender_set_material` | Sets a Principled BSDF material on an object. | | `blender_execute_python` | Executes arbitrary Python code within Blender. | ## Configuration ``` blender-mcp-bridge/ ├── bridge.py # MCP server core (conversion and TCP transfer) ├── scripts/ │ ├── setup.py # Batch setup for all clients (interactive menu) │ ├── setup_claude_desktop.py # Claude Desktop │ ├── setup_claude_code.py # Claude Code (CLI) │ ├── setup_gemini.py # Gemini CLI │ ├── setup_vscode.py # VS Code (all MCP-enabled extensions) │ └── setup_codex.py # OpenAI Codex CLI └── pyproject.toml ``` ※ Note: The author does not have access to the environment, so the setup_vscode.py and setup_codex.py scripts have not been verified. ## License Apache License 2.0 — see [LICENSE](LICENSE) for details. As an experiment in program development, OpenSpec is being trial-introduced. Therefore, `.claude/skills/openspec-*` and `.claude/commands/opsx/*` are based on the OpenSpec license.