# 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`).

## 2. Run MCP server

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

Optional env (defaults shown):

```powershell
$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:

```json
{
  "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):

```json
"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`.