MCP Blend

🚀 MCP-Blender 服务器 for Blender

MCP-Blender 服务器借助 Model Context Protocol 实现了 Blender 与 Claude AI 的对接，让 Claude 能够直接与 Blender 交互和控制，实现快速、自然的 3D 模型创作，还支持参数化设计和关联式设计。未来还计划推出适用于 CATIA、SolidWorks 等其他 CAD 软件的 MCP-Server。

🚀 快速开始

MCP-Blender 服务器通过 Model Context Protocol 达成 Blender 和 Claude AI 的对接，使 Claude 可直接与 Blender 交互控制，实现 3D 模型的快速自然创作，支持参数化与关联式设计。

✨ 主要特性

1. 软件连接：使用 MCP 将 Blender 等 CAD 软件与服务器连接。
2. 模型创建：在 Blender 中创建模型。
3. 代码执行：在 Blender 中执行临时代码。

📦 安装指南

安装步骤 #1：安装 UV Package

1. 安装 UV 和 UVX

   pip install uv 
   

   • 参考文档：https://docs.astral.sh/uv/getting-started/installation/#__tabbed_1_2

2. 检查安装版本

   uv --version
   uvx --version 
   

3. 安装路径检查

   • 如果在虚拟环境中安装，请建议指定完整路径的方法

   # 安装路径检查 
   where uvx 
   

4. 克隆代码库或下载文件夹

   git clone https://github.com/piolla/mcp-blend
   cd mcp-blend
   

安装步骤 #2：Blender 插件

1. 下载 blender_addon.py 文件。
2. 打开 Blender：
   • 转到菜单栏的 Edit -> Preferences -> Add-ons -> Inrell Add-on，然后选择下载的 blender_addon.py 文件路径。
   • 激活插件：勾选 Interface: Blender MCP 复选框。

安装步骤 #3：Claude AI 配置

1. 打开 Claude AI。

2. 进入菜单栏的 文件 -> 设置 -> 开发者 -> 设置编辑：

   • 在文件浏览器中找到并修改 claude_desktop_config.json 文件，参考以下内容进行配置

   {
       "mcpServers":
       {
           "Blender":
           {
               "command": "D:\\Anaconda\\envs\\aria\\Scripts\\uvx.exe",
               "args": ["blender-mcp" ]
           }
       }
   }
   

3. 保存修改后，退出并重新启动 Claude AI：

   • 在文件菜单中选择 退出。
   • 再次启动 Claude AI 并检查连接状态。

🔧 技术细节

需要的组件

1. Blender （版本 3.5 或更高）
2. Claude AI
3. Python （版本 3.10 或更高）
4. UV Package

📄 许可证

文档未提及相关许可证信息。

⚠️ 重要提示

• Blender 版本变化可能导致无法正常运行。此外，可能会执行任意 Python 代码，存在潜在风险。
• 如果不再使用，请在 Blender 的编辑界面中禁用 Blender MCP 功能。

💡 使用建议

blender_addon.py 是 Siddharth（https://x.com/sidahuj）先生编写的作品，在此表示感谢。