JinDaGe - mcp-blend MCP Details

article

README

🚀 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）先生编写的作品，在此表示感谢。

mcp-blend