内容
MCP 服务器
**通过 API 实现对 Blender 的完全控制上下文协议（MCP）该插件将 Blender 服务器，暴露了 种强大的工具，可以通过 HTTP 端 AI 代理协调。适用于 AI 驱动的 3D、自动化和创意实验。
功能
- **50+ 工具** - 对的完全控制：
创建、操作和变换
材料和着色器系统 - 动画和关键
- 相机和灯光设置
- 修饰器和约束
- 物理模拟（刚体、布料、流体）
几何节点和
-导出操作
-和批量操作
- **🔒 线程安全执行** - 企业级队列系统，用于安全的并发操作
- **📦 自动安装依赖项** - 在第一次运行时自动安装所需的包
- **🎮 简单的 UI 面板** - 从 Blender 的 N 面板一键启动/停止服务器
- **📊 实时监控** - 跟踪操作、统计数据和服务器状态
- **🔧 生产就绪** - 全面的错误处理、日志记录和缓存
## 🚀 快速入门
### 安装
1. 下载 `blender_mcp.py`
2. 打开 Blender
3. 进入 **编辑 → 首选项 → 插件**
4. 点击搜索栏旁边的 **下拉箭头**（⌄）
5. 选择 **从磁盘安装...**
6. 选择下载的 `blender_mcp.py` 文件
7. 通过选中"MCP Complete Server for Blender"旁边的框来启用插件
### 启动服务器
1. 在 3D 视口中按 **N** 打开侧栏
2. 导航到 **MCP 服务器**选项卡
3. 点击 **启动服务器**
4. 服务器将在 `http://localhost:8000` 启动
插件将在首次运行时自动安装所需的依赖项（FastAPI、Uvicorn、Pydantic 等）。
## 🤖 与 PolyMCP 一起使用
该 MCP 服务器旨在与 **[PolyMCP](https://github.com/llm-use/Polymcp)** 无缝协作 - 一个用于使用 AI 代理协调 MCP 服务器的强大框架。
### 示例：AI 控制的 Blender
```python
#!/usr/bin/env python3
import asyncio
from polymcp.polyagent import UnifiedPolyAgent, OllamaProvider
async def # 初始化您的 LLM
llm = Ollamagpt-oss:", temperature=0)
# 连接到 Blender MCP 服务器
agent = UnifiedPolyAgent(
llm_providerm,
mcp://localhost:800cp"],
verbose=True
async with print("✅ Blender MCP连接！\n")
# 与 AI 聊天 Blender
while True user_input = input("\n：")
_input.lower() in ['exit', 'quit']:
break
= await agent.run_async(user max_steps=5)
"\n🤖 Blender：}")
if __name__main__":
asyncio.run### 示例命令
连接后，您可以要求 AI 代理： *"在位置 ( 0, 0)大小为 2 的立方体"*
- *"为选添加红色金属材质" *"创建一个朝向原点的*
- *"设置一个3 个灯光的简单照明场景- *"为立方体添加流体模拟"*
将场景导出为 FBX 文件"*
- *"创建一个对象在 100 帧内旋转 360 度"*
**！** PolyMCP 处理了所有的复杂性：
- 工具发现和选择
- 多步骤任务规划
- 错误处理和重试
- 跨操作的 state 管理
这使得构建 AI 驱动的 Blender 自动化工具变得非常简单！
## 📡 API 端点
一旦服务器运行，您就可以访问：
- **API 文档**：`http://localhost:8000/docs`
- **列出所有工具**：`http://localhost:8000/mcp/list_tools`
- **调用工具**：`POST http://localhost:8000/mcp/invoke/{}`
## 用工具类别
<details>
>查看所有工具类别（工具）</- **对象操作**：、复制、选择- **变换**：移动、旋转、缩放、应用变换 **材质和着色创建材质、添加纹理着色器节点
- **建模**：添加、布尔运算、- **动画**：、时间轴控制、NLA 编辑器
- **灯光**：相机设置光创建、HDRI- **渲染**：输出配置、渲染
- **物理**：刚体、流体模拟 **几何节点**：生成、节点树创建
文件操作**：导入格式（FBX、USD 等）
- ****：场景信息、清理、优化
- **批量：多对象创建和- **高级**：粒子场、 grease pencil>
## 🔧可以通过编辑 `bl.py` 中的 `Config来定制服务器：
class Config:
"0.0.0" # 服务器主机 = 8000 服务器端口
AUTOAGES = True # 自动安装依赖项
THREAD = True # 安全执行
ENABLE = True #结果缓存
```
## 要求
插件会自动依赖项：
-
- Uvicorn
ydantic
- doc
- NumPy
MCP
**Bl**：3.0 或更高
## 故障排除
**服务器？**
- 检查 Blender 的系统控制台中的错误消息（窗口 → 切换系统控制台）
保端口 8000占用
- 在安装后启动 Blender
**依赖安装？**
- 使用 Python 手动安装包bash
/path/python -mapi uvicorn pydantic docstring-parser numpy
```
**找不到 MCP 服务器面板？**
- 在 3D 视口中按 **N**
- 在侧栏中查找"MCP 服务器"选项卡
- 确保在首选项中启用了插件
## 🤝 贡献
欢迎贡献！该项目演示了如何为 PolyM强大的 MCP 服务器。
## 📝 许可证
MIT 许可证 - 有关详细信息，请参见 LICENSE 文件
## 🔗 相关项目
- **[CP](https.com/llm-useymcp)** - 使用自定义 服务器交互的简单
- **[模型上下文://modelcontextprotocol** - 用于与 LLM集成的开放协议
💡 为什么创建这个项目创建此 MCP 服务器是为了MCP 使构建 AI 驱动的工具变得多么只需几行：
1. Blender 功能公开为 MCP 工具
2. 让 AI发现和协调这些工具
为 3D自然语言接口
无需复杂的提示、无需手动工具选择、无需状态管理 - PolyMCP 处理所有这些！
---
**为 [
