Blender MCP 服务器

模型上下文协议（MCP）服务器，通过API实现对Blender的完全控制

此插件将Blender转变为一个MCP服务器，通过HTTP端点暴露超过50种强大的工具，这些工具可以由AI代理进行编排。非常适合用于AI驱动的3D工作流程、自动化和创意实验。

✨ 特性

• 🚀 50+ 工具 - 对Blender功能的完全控制：

  • 对象创建、操作和变换
  • 材质和着色系统管理
  • 动画和关键帧控制
  • 摄像机和灯光设置
  • 修改器和约束
  • 物理模拟（刚体、布料、流体）
  • 几何节点和程序生成
  • 文件导入/导出操作
  • 场景优化和批量操作

• 🔒 线程安全执行 - 企业级队列系统，确保并发操作的安全性

• 📦 自动安装依赖项 - 首次运行时自动安装所需包

• 🎮 简单UI面板 - 从Blender的N面板一键启动/停止服务器

• 📊 实时监控 - 跟踪操作、统计数据和服务器状态

• 🔧 生产就绪 - 完整的错误处理、日志记录和缓存

🚀 快速开始

安装

1. 下载 blender_mcp.py
2. 打开Blender
3. 前往 编辑 → 首选项 → 插件
4. 点击搜索栏旁边的下拉箭头 (⌄)
5. 选择 从磁盘安装...
6. 选择下载的 blender_m_ cp.py 文件
7. 通过勾选“Blender的MCP完整服务器”旁边的框来启用插件

启动服务器

1. 在3D视图中按 N 打开侧边栏
2. 导航到 MCP服务器 标签页
3. 点击 启动服务器
4. 服务器将在 http://localhost:8000 上启动

插件在首次运行时会自动安装所需的依赖项（如FastAPI、Uvicorn、Pydantic等）。

🤖 使用PolyMCP

此MCP服务器设计为与 PolyMCP 无缝协作——这是一个强大的框架，用于使用AI代理编排MCP服务器。

示例：AI控制的Blender

#!/usr/bin/env python3
import asyncio
from polymcp.polyagent import UnifiedPolyAgent, OllamaProvider

async def main():
    # 初始化您的LLM提供商
    llm = OllamaProvider(model="gpt-oss:120b-cloud", temperature=0.1)
    
    # 连接到Blender MCP服务器
    agent = UnifiedPolyAgent(
        llm_provider=llm, 
        mcp_servers=["http://localhost:8000/mcp"],  
        verbose=True
    )
    
    async with agent:
        print("✅ Blender MCP服务器已连接！\n")
        
        # 与您的AI聊天以控制Blender
        while True:
            user_input = input("\n🎨 您：")
            
            if user_input.lower() in ['exit', 'quit']:
                break
            
            result = await agent.run_async(user_input, max_steps=5)
            print(f"\n🤖 Blender：{result}")

if __name__ == "__main__":
    asyncio.run(main())

示例命令

一旦连接，您可以要求AI代理：

• "在位置(0, 0, 0)创建一个大小为2的立方体"
• "给选定的对象添加红色金属材质"
• "创建一个朝向原点的摄像机"
• "设置一个带有3盏灯的简单照明场景"
• "给立方体添加流体模拟"
• "将场景导出为FBX文件"
• "创建一个动画，在100帧内旋转对象360度"

就是这样！ PolyMCP处理所有复杂性：

• 工具发现和选择
• 多步骤任务规划
• 错误处理和重试
• 操作之间的状态管理

这使得构建AI驱动的Blender自动化工具变得非常简单！

📡 API端点

一旦服务器运行，您可以访问：

• API文档：http://localhost:8000/docs
• 列出所有工具：http://localhost:8000/mcp/list_tools
• 调用工具：POST http://localhost:8000/mcp/invoke/{tool_name}

🛠️ 可用工具类别

<details> <summary>查看所有工具类别（100+工具）</summary>

• 对象操作：创建、删除、复制、选择对象
• 变换：移动、旋转、缩放、应用变换
• 材质与着色：创建材质、添加纹理、设置着色器节点
• 建模：添加修改器、布尔运算、网格编辑
• 动画：关键帧、时间线控制、NLA编辑器
• 摄像机与灯光：摄像机设置、灯光创建、HDR环境
• 渲染：渲染设置、输出配置、渲染
• 物理：刚体、布料、流体模拟
• 几何节点：程序生成、节点树创建
• 文件操作：导入/导出各种格式（FBX、OBJ、USD等）
• 场景管理：场景信息、清理、优化
• 批量操作：多对象创建和变换
• 高级：粒子系统、力场、铅笔工具

</details>

🔧 配置

您可以通过编辑 blender_mcp.py 中的 Config 类来自定义服务器：

class Config:
    HOST = "0.0.0.0"           # 服务器主机
    PORT = 8000                # 服务器端口
    AUTO_INSTALL_PACKAGES = True  # 自动安装依赖项
    THREAD_SAFE_OPERATIONS = True  # 启用线程安全执行
    ENABLE_CACHING = True      # 启用结果缓存

📋 要求

插件会自动安装以下依赖项：

• FastAPI
• Uvicorn
• Pydantic
• docstring-parser
• NumPy
• PolyMCP

Blender版本：3.0.0或更高版本

🐛 故障排除

服务器无法启动？

• 检查Blender的系统控制台中的错误消息（窗口 → 切换系统控制台）
• 确保端口8000未被占用
• 尝试在安装后重新启动Blender

依赖项未安装？

• 使用Blender的Python手动安装包：

  /path/to/blender/python -m pip install fastapi uvicorn pydantic docstring-parser numpy
  

找不到MCP服务器面板？

• 在3D视图中按 N
• 查找侧边栏中的"MCP服务器"标签页
• 确保插件已在首选项中启用

🤝 贡献

欢迎贡献！这个项目展示了如何使用PolyMCP轻松地创建强大的MCP服务器。

📝 许可证

MIT许可证 - 详情见LICENSE文件

🔗 相关项目

• PolyMCP - 使用自定义代理与MCP服务器交互的简单高效方法
• 模型上下文协议 - 与LLMs集成的开放协议

💡 为什么是这个项目？

此MCP服务器旨在展示PolyMCP如何使构建AI驱动的工具变得极其简单。只需几行代码，您就可以：

1. 将复杂的Blender功能作为MCP工具公开
2. 让AI代理发现并编排这些工具
3. 构建用于3D创作的自然语言接口

无需复杂的提示、无需手动选择工具、无需状态管理——PolyMCP处理一切！

---

专为 PolyMCP 设计

如果您觉得有用，请给这个仓库加星⭐!