Blender MCP Senpai

An AI-assisted mentor for Blender that detects topology issues and offers real-time improvement suggestions.

GitHub

Blender Senpai Logo

Blender MCP Senpai

Your AI-assisted mentor for Blender.

CI Blender 4.2+ GPL-3.0 Sponsor Discord

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

FeatureStatus
✅Auto n-gon Highlight – instantly spot topology issuesImplemented
✅AI Comments – ChatGPT / Claude / Gemini suggest improvementsImplemented
✅Zero Configuration – works out-of-the-box, no external MCP clientImplemented
🚧Asset Store IntegrationPlanned

📺 Demo

Blender Senpai Demo

🛠️ Quick Start

Install Blender Senpai Demo

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

Related Servers