Blender Mcp Senpai
What is Blender Mcp Senpai
Blender MCP Senpai is a tool designed to enhance the Blender experience by integrating with the Model Context Protocol (MCP), allowing users to manage and interact with Blender documents more effectively.
Use cases
Use cases for Blender MCP Senpai include efficiently searching and indexing large Blender projects, integrating AI tools for enhanced productivity, and managing resources and versions within Blender.
How to use
To use Blender MCP Senpai, open Blender and navigate to Edit > Preferences > Get Extensions > Repositories. Add the repository URL provided and search for ‘MCP Senpai’ to install it. For AI agents like Claude or Cursor, configure the JSON settings as specified in the installation instructions.
Key features
Key features include indexing Blender documents, searching documents using DuckDB-VSS, installing the MCP server via a repository, and the ability to send Blender screenshots through MCP.
Where to use
Blender MCP Senpai is primarily used in the field of 3D modeling and animation, specifically within the Blender software environment, to streamline workflows and enhance document management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Blender Mcp Senpai
Blender MCP Senpai is a tool designed to enhance the Blender experience by integrating with the Model Context Protocol (MCP), allowing users to manage and interact with Blender documents more effectively.
Use cases
Use cases for Blender MCP Senpai include efficiently searching and indexing large Blender projects, integrating AI tools for enhanced productivity, and managing resources and versions within Blender.
How to use
To use Blender MCP Senpai, open Blender and navigate to Edit > Preferences > Get Extensions > Repositories. Add the repository URL provided and search for ‘MCP Senpai’ to install it. For AI agents like Claude or Cursor, configure the JSON settings as specified in the installation instructions.
Key features
Key features include indexing Blender documents, searching documents using DuckDB-VSS, installing the MCP server via a repository, and the ability to send Blender screenshots through MCP.
Where to use
Blender MCP Senpai is primarily used in the field of 3D modeling and animation, specifically within the Blender software environment, to streamline workflows and enhance document management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
| 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 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 Senpaiand 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
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
