blender-mcp-senpai

<p align="center"> <img src="docs/assets/logo.png" alt="Blender Senpai Logo" width="240" height="240"> </p> <h1 align="center">Blender MCP Senpai</h1> <p align="center"><em>Your AI-assisted mentor for Blender.</em></p> <p align="center"> <a href="https://github.com/xhiroga/blender-mcp-senpai/actions"> <img alt="CI" src="https://github.com/xhiroga/blender-mcp-senpai/actions/workflows/ci.yml/badge.svg"> </a> <img alt="Blender 4.2+" src="https://img.shields.io/badge/Blender-4.2%2B-orange?logo=blender"> <img alt="GPL-3.0" src="https://img.shields.io/badge/license-GPL--3.0-blue"> <a href="https://github.com/sponsors/xhiroga"> <img alt="Sponsor" src="https://img.shields.io/github/sponsors/xhiroga?style=social"> </a> <a href="https://discord.gg/7z9HqgR8Bd"> <img alt="Discord" src="https://img.shields.io/discord/1352831203597877311?label=Discord&logo=discord&style=flat"> </a> </p> --- <h2 align="center">Feedback welcome! Feel free to open an <a href="https://github.com/xhiroga/blender-mcp-senpai/issues">Issue</a> or join our <a href="https://discord.gg/7z9HqgR8Bd">Discord</a></h2> --- ## ✨ 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 | | Feature | Status | |---|---|---| | ✅ | **Auto n-gon Highlight** – instantly spot topology issues | Implemented | | ✅ | **AI Comments** – ChatGPT / Claude / Gemini suggest improvements | Implemented | | ✅ | **Zero Configuration** – works out-of-the-box, no external MCP client | Implemented | | 🚧 | Asset Store Integration | Planned | --- ## 📺 Demo [](https://www.youtube.com/watch?v=4oX0ftZ07LE) --- ## 🛠️ Quick Start [](https://www.youtube.com/watch?v=COK-hvvCgMM) ### 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. ```json { "mcpServers": { "blender-senpai": { "command": "npx", "args": [ "-y", "supergateway", "--sse", "http://localhost:13180/sse" ] } } } ``` ### To Dive ```json { "mcpServers": { "blender-senpai": { "transport": "sse", "enabled": true, "command": null, "args": [], "env": {}, "url": "http://localhost:13180/sse" } } } ``` ## 🔧 Development See [.github/pull_request_template.md](.github/pull_request_template.md). ### Release ```sh # 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 ```