🚀 MCP-Blender 服务器 for Blender
MCP-Blender 服务器致力于实现 Blender 与 Claude AI 的无缝对接，借助 Model Context Protocol 协议，让 Claude AI 能够直接与 Blender 交互和控制，显著提升 3D 模型创作的效率和自然度，同时支持参数化设计和关联式设计。未来，还计划推出适用于 CATIA、SolidWorks 等其他 CAD 软件的 MCP-Server。
🚀 快速开始
以下将详细介绍 MCP-Blender 服务器的安装与配置步骤，确保你能顺利使用其功能。
✨ 主要特性
- 软件对接：使用 MCP 协议将 Blender 等 CAD 软件与服务器连接。
- 模型创建：可在 Blender 中轻松创建模型。
- 代码执行：支持在 Blender 中执行临时代码。
📦 安装指南
安装步骤 #1：安装 UV Package
-
安装 UV 和 UVX
pip install uv- 参考文档：UV 安装文档
-
检查安装版本
uv --version uvx --version -
安装路径检查
- 若在虚拟环境中安装，建议指定完整路径。
# 安装路径检查 where uvx -
克隆代码库或下载文件夹
git clone https://github.com/piolla/mcp-blend cd mcp-blend
安装步骤 #2：Blender 插件
- 下载
blender_addon.py文件。 - 打开 Blender，依次转到菜单栏的 Edit -> Preferences -> Add-ons -> Inrell Add-on，然后选择下载的
blender_addon.py文件路径。 - 激活插件：勾选 Interface: Blender MCP 复选框。
安装步骤 #3：Claude AI 配置
- 打开 Claude AI。
- 进入菜单栏的 文件 -> 设置 -> 开发者 -> 设置编辑，在文件浏览器中找到并修改
claude_desktop_config.json文件，参考以下内容进行配置：
{
"mcpServers":
{
"Blender":
{
"command": "D:\\Anaconda\\envs\\aria\\Scripts\\uvx.exe",
"args": ["blender-mcp" ]
}
}
}
- 保存修改后，退出并重新启动 Claude AI。在文件菜单中选择 退出，再次启动 Claude AI 并检查连接状态。
📚 详细文档
需要的组件
| 属性 | 详情 |
|---|---|
| 软件依赖 | Blender（版本 3.5 或更高）、Claude AI、Python（版本 3.10 或更高） |
| 额外包 | UV Package |
⚠️ 重要提示
- Blender 版本变化可能导致无法正常运行。此外，可能会执行任意 Python 代码，存在潜在风险。
- 如果不再使用，请在 Blender 的编辑界面中禁用 Blender MCP 功能。
💡 使用建议
blender_addon.py 是 Siddharth（https://x.com/sidahuj）先生编写的作品，在此表示感谢。