本文于 2025-03-12 18:14 更新,部分内容具有时效性,如有失效,请留言
综合介绍
BlenderMCP 是一个开源工具,它通过 Model Context Protocol (MCP) 协议将 Blender 与 Claude AI 连接起来。用户可以用文字指令直接控制 Blender,快速创建和编辑 3D 模型、场景和材质。这个工具适合 3D 设计师、开发者以及爱好者,能显著提高建模效率。它包含一个 Blender 插件和一个 MCP 服务端,支持双向通信、对象操作和场景查看等功能。BlenderMCP 目前在 GitHub 上免费提供,任何人都可以下载使用或参与开发。
功能列表
- 双向通信:通过 socket 服务器实现 Claude AI 与 Blender 的实时互动。
- 对象操作:能在 Blender 中创建、修改或删除 3D 对象。
- 材质调整:支持为对象添加或改变材质和颜色。
- 场景查看:获取当前 Blender 场景的详细信息。
- 代码执行:通过 Claude 在 Blender 中运行 Python 代码。
使用帮助
安装流程
BlenderMCP 需要安装两个部分:Blender 插件和 MCP 服务端。以下是具体步骤:
准备工作
- 软件要求:需要 Blender 3.0 或以上版本,以及 Python 3.10 或以上版本。
- 下载插件:访问 GitHub 页面,下载
addon.py
文件。
安装 Blender 插件
- 打开 Blender,点击菜单栏的 编辑 > 偏好设置 > 插件。
- 点击 安装 按钮,选择下载好的
addon.py
文件。 - 安装完成后,在插件列表中找到 Interface: Blender MCP,勾选启用。
启动 MCP 服务端
- 打开终端,输入命令启动服务端:
uvx blender-mcp
- 如果你在 Mac 上,先安装 uv 工具:
brew install uv
- Windows 或其他系统用户,请查看 uv 官网 获取安装方法。
配置 Claude 桌面版(可选)
如果你使用 Claude 的桌面版,可以让它自动运行 BlenderMCP。具体操作如下:
- 找到配置文件路径:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
- 编辑文件,添加以下内容:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}
- 保存后,Claude 会在需要时自动启动 MCP 服务端。
启动连接
- 在 Blender 中,按 N 键打开 3D 视图侧边栏。
- 找到 BlenderMCP 选项卡。
- 设置端口号,默认是 9876(一般不用改)。
- 点击 Start MCP Server 启动插件内的服务器。
- 确认终端中 MCP 服务端也在运行(即执行了
uvx blender-mcp
)。
如何使用主要功能
连接成功后,你可以通过 Claude AI 输入文字指令操作 Blender。以下是具体用法:
查看场景信息
- 指令:输入 "Get information about the current scene"。
- 效果:Claude 调用
get_scene_info
工具,返回场景中的对象数量、位置等信息。 - 操作步骤:在 Claude 界面输入指令,等待几秒后查看返回结果。
创建简单对象
- 指令:输入 "Create a sphere and place it above the cube"。
- 效果:通过
create_primitive
,Blender 生成一个球体并放在立方体上方。 - 操作步骤:输入指令后,Claude 会自动完成创建,你可以在 Blender 中看到结果。
调整对象材质
- 指令:输入 "Make this car red and metallic"。
- 效果:使用
set_material
和modify_object
,将车的材质改为红色金属质感。 - 操作步骤:确保场景中有车对象,输入指令后检查材质变化。
删除对象
- 指令:输入 "Delete the cube"。
- 效果:调用
delete_object
,移除场景中的立方体。 - 操作步骤:输入指令后,回到 Blender 确认立方体已消失。
运行 Python 代码
- 指令:输入 "Run this code in Blender: bpy.ops.mesh.primitive_uv_sphere_add(radius=2, location=(0,0,5))"。
- 效果:通过
execute_blender_code
,在 Blender 中创建一个半径为 2、位置在 (0,0,5) 的球体。 - 操作步骤:输入完整指令,Claude 会将代码发送到 Blender 执行。注意:运行前先保存文件,以防出错。
创建复杂场景
- 指令:输入 "Create a low poly scene in a dungeon, with a dragon guarding a pot of gold"。
- 效果:Claude 会逐步调用多个工具,生成低多边形地牢、龙和金罐场景。
- 操作步骤:输入指令后等待片刻,Blender 会显示完整场景。参考 。
操作流程
- 启动服务:按“启动连接”步骤,确保 Blender 插件和 MCP 服务端都运行。
- 输入指令:在 Claude 界面输入你想执行的操作,比如创建对象或调整灯光。
- 确认结果:回到 Blender,查看场景是否按指令更新。
- 解决问题:如果没反应,打开 Blender 的控制台(窗口 > 切换控制台),查看错误信息。
注意事项
- 简化任务:复杂指令可能需要拆成小步骤,比如先创建对象,再修改属性。
- 安全提示:使用
execute_blender_code
时要小心,避免运行未知代码导致程序崩溃。 - 连接失败:如果无法连接,检查端口号是否一致,防火墙是否阻拦。
通过这些操作,你可以用简单的文字指令在 Blender 中快速构建 3D 模型和场景,省时又方便!
一句话描述(简介)
BlenderMCP 是一个开源工具,通过 Model Context Protocol 连接 Blender 和 Claude AI,用户可以用文字指令在 Blender 中创建和修改 3D 模型、场景及材质,支持对象操作、材质调整和 Python 代码执行,适合快速生成高质量 3D 内容。