🧠 MCP搅拌机桥
> 通过模型上下文协议将Google Gemini连接到Blender。
> 使用自然语言安全高效地编排复杂的3D工作流程。
🚀 引言
MCP搅拌机桥 是一个专业级的集成,允许大型语言模型(如Google Gemini)控制Blender。
与简单的“代码注入”脚本不同,该项目使用 模型上下文协议(MCP) 建立安全、结构化和状态感知的通信信道。它将Blender转化为一组人工智能可以发现、学习和执行的智能工具。
📖 故事:为什么是这种建筑?
我们不仅仅建造了一座桥;我们建了一座堤坝来抵御混乱。
我们的旅程使我们摆脱了危险 exec() 呼吁稳健 受控注射 系统。
👉 在此处阅读我们技术发展的完整故事 (法语)
🏗️ 建筑
该系统依赖于 桥接协议 以确保稳定性(Blender不喜欢从外部触摸)和安全性。```mermaid
graph LR
subgraph "AI Layer"
Gemini[🤖 Google Gemini]
end
subgraph "MCP Server (Controller)"
API[FastAPI Server]
Inventory[📚 Dual Inventory]
Validator[🛡️ Security Validator]
end
subgraph "Blender (Peripheral)"
Addon[🔌 Blender Addon]
BPY[🐍 BPY API]
end
Gemini <-->|"MCP Protocol (Tools)"| API
API <--> Inventory
API -->|"1. Generate Script"| Validator
Validator -->|"2. Validated Command"| API
Addon -->|"3. Long Polling"| API
API -->|"4. Command"| Addon
Addon -->|"5. Execution"| BPY
## ✨ 主要特点
- **🛡️ 设计安全**:没有任意代码执行。每个命令都经过严格的工具列表验证。
- **🧠 双重库存系统**:
- **能力**:原子、低级工具(例如。, `mesh.create_cube`).
- **知识库**:复杂物体的高级“食谱”(例如。, `furniture.chair`).
- **🔍 动态发现(RAG)**:AI根据需要搜索工具,防止上下文窗口溢出。
- **🔌 坚固的桥梁**:使用HTTP长轮询与Blender的主线程通信,而不会冻结UI。
- **📝 检查与学习**:AI可以在使用工具之前检查工具以了解其参数。
## 📚 文档
在 `docs/` 文件夹:
|文档|描述|
| :--- | :--- |
| **用户指南** | 🎓 安装、配置和第一步。 |
| **建筑** | 🏗️ 深入了解系统设计和协议。 |
| **开发者指南** | 💻 如何贡献、添加工具和调试。 |
| **api参考** | ⚙️ 端点和模式的技术细节。 |
## ⚡ 快速入门(Windows)
### 选项A:简易方法(安装程序)
1. 首选 `installer_build/` 然后跑 **`mcp_installer.exe`**.
1. 按照提示配置API密钥。
1. 打开Blender,寻找 **Gemini MCP** 侧边栏中的选项卡(`N`).
### 选项B:手动方式
1. **控制器**:```bash
cd controller
uvicorn app.main:app --reload
- 搅拌机:
- 从安装插件blender_addon/.
- 在加载项首选项中设置API密钥。
- 点击 连接 在“三维视口”侧栏中(N).
🤝 贡献
我们欢迎捐款!无论是在库存中添加新工具还是改进核心桥梁。
请阅读 贡献.md 和那个 开发者指南 在跳进去之前。
内置于❤️ Blender和AI社区。
