Blender MCP Senpai

Your AI-assisted mentor for Blender.

Feedback welcome! Feel free to open an Issue or join our Discord

✨ TL;DR

• Instantly detects and highlights n-gons and topology issues
• ChatGPT / Claude / Gemini offer real-time improvement suggestions
• Zero-setup: just install the add-on — no external MCP server required

🚀 Features

📺 Demo

🛠️ Quick Start

To Blender

• Open Blender
• Go to Edit > Preferences > Get Extensions > Repositories > + > Add Remote Repository
• Add https://xhiroga.github.io/blender-mcp-senpai/extensions/index.json
• Search Blender Senpai and install it
• Add-ons > Blender Senpai > Enable it

To Claude, Cline, Roo Code

NOTE: After configuration, you need to restart the app. Especially on Windows, please terminate the process from Task Manager.

{
    "mcpServers": {
        "blender-senpai": {
            "command": "npx",
            "args": [
                "-y",
                "supergateway",
                "--sse",
                "http://localhost:13180/sse"
            ]
        }
    }
}

To Dive

{
  "mcpServers": {
    "blender-senpai": {
      "transport": "sse",
      "enabled": true,
      "command": null,
      "args": [],
      "env": {},
      "url": "http://localhost:13180/sse"
    }
  }
}

🔧 Development

See .github/pull_request_template.md.

Release

# Update version in `pyproject.toml`
uv run --env-file .env build.py
# Install extension to Blender and check if it works.
git add docs/extensions/index.json pyproject.toml uv.lock
./scripts/release.sh