🧠 MCP搅拌机桥
通过模型上下文协议将Google Gemini连接到Blender。 *使用自然语言安全高效地编排复杂的3D工作流程。*
______________________________________________________________________
🚀 引言
MCP搅拌机桥 是一个专业级的集成，允许大型语言模型（如Google Gemini）控制Blender。
与简单的“代码注入”脚本不同，该项目使用 模型上下文协议（MCP） 建立安全、结构化和状态感知的通信信道。它将Blender转化为一组人工智能可以发现、学习和执行的智能工具。
📖 故事：为什么是这种建筑？
我们不仅仅建造了一座桥；我们建了一座堤坝来抵御混乱。 我们的旅程使我们摆脱了危险 exec() 呼吁稳健 受控注射 系统。
👉 在此处阅读我们技术发展的完整故事 （法语）
🏗️ 建筑
该系统依赖于 桥接协议 以确保稳定性（Blender不喜欢从外部触摸）和安全性。
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/ 文件夹：
⚡ 快速入门（Windows）
选项A：简易方法（安装程序）
- 首选
installer_build/然后跑mcp_installer.exe. - 按照提示配置API密钥。
- 打开Blender，寻找 Gemini MCP 侧边栏中的选项卡(
N).
选项B：手动方式
- 控制器:
cd controller
uvicorn app.main:app --reload- 搅拌机:
- 从安装插件 blender_addon/. - 在加载项首选项中设置API密钥。 - 点击 连接 在“三维视口”侧栏中(N).
🤝 贡献
我们欢迎捐款！无论是在库存中添加新工具还是改进核心桥梁。 请阅读 贡献.md 和那个 开发者指南 在跳进去之前。
______________________________________________________________________
*内置于❤️ Blender和AI社区。*