Blendy Blender MCP — Addon Installation

Self-contained MCP server + Blender addon.

blender-mcp/
  mcp_server.py   # FastMCP server (3 tools)
  addon/blender_addon.py

1. Install addon in Blender

1. Open Blender (3.0+).

2. Edit > Preferences > Add-ons > Install...

3. Select blender-mcp/addon/blender_addon.py → Install Add-on.

4. Enable Interface: Blendy Blender MCP.

5. In the 3D Viewport press N → Blendy tab → Start Server (default localhost:9876).

Related MCP server: Blender MCP Server

2. Run MCP server

cd blender-mcp
uv run mcp_server.py
# or: pip install -r requirements.txt; python mcp_server.py

Optional env (defaults shown):

$env:BLENDER_HOST = "localhost"
$env:BLENDER_PORT = "9876"

3. Configure opencode

Easiest (portable, no paths to edit): drop an opencode.json in this repo root — cwd defaults to the workspace, so it works wherever you cloned it:

{
  "mcp": {
    "servers": {
      "blendy-blender-mcp": {
        "type": "local",
        "command": ["uv", "run", "mcp_server.py"],
        "environment": {
          "BLENDER_HOST": "localhost",
          "BLENDER_PORT": "9876"
        }
      }
    }
  }
}

Global config instead (~/.config/opencode/opencode.json)? Same block, but add "cwd" pointing at your clone (absolute path, \\ on Windows):

"blendy-blender-mcp": {
  "type": "local",
  "command": ["uv", "run", "mcp_server.py"],
  "cwd": "D:\\blender-mcp",
  "environment": { "BLENDER_HOST": "localhost", "BLENDER_PORT": "9876" }
}

No uv? Use "command": ["python", "mcp_server.py"] (after pip install -r requirements.txt). Restart opencode after editing the config.

4. Verify

1. Blender: Blendy tab shows server running.

2. In opencode ask: get_scene_info — should return JSON with objects/materials.

3. If it fails: addon not started, wrong host/port, or firewall blocking 9876.