Blender Mcp Senpai
About
An AI-assisted mentor for Blender that detects topology issues and offers real-time improvement suggestions.
Details
- Author
- xhiroga
- Downloads
- 478
- Categories
- Developer Tools, AI, Other
Jump to
- Auto n-gon highlight – instantly spots topology issues
- AI comments from ChatGPT, Claude, or Gemini
- Zero configuration – works out-of-the-box
- No external MCP server required
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Blender Mcp SenpaiCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the add-on in Blender (requires Blender 4.2+). No further setup is needed for the basic topology detection. To enable AI suggestions, configure an MCP-compatible client (e.g., Claude Desktop or Dive) to connect to http://localhost:13180/sse using the JSON configuration provided in the README. After restarting the client, AI comments will appear for detected topology issues.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"blender mcp senpai": {
"blender-senpai": {
"command": "npx",
"args": [
"-y",
"supergateway",
"--sse",
"http://localhost:13180/sse"
]
}
}
}
}McpServers
{
"blender-senpai": {
"command": "npx",
"args": [
"-y",
"supergateway",
"--sse",
"http://localhost:13180/sse"
]
}
}<p align="center">
</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">
</a>
<a href="https://github.com/sponsors/xhiroga">
</a>
<a href="https://discord.gg/7z9HqgR8Bd">
</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
---
🛠️ Quick Start
To Claude
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
