BlenderMCP：通过MCP协议让Claude AI直接控制Blender | ahujasid/blender-mcp

📌 项目地址：ahujasid/blender-mcp | ⭐ 22,126 颗星 | 🔧 Python | 📜 MIT

一句话说清楚项目本质

BlenderMCP 是一个连通 Blender 和 Claude AI 的中间件。它的工作方式是：你在 Claude 对话框里用自然语言描述需求，Claude 理解后直接向 Blender 发指令——创建物体、改材质、执行 Python 脚本，都包了。

和之前的 AI 辅助 3D 工具不同，Claude 不再是“建议你该怎么做”，而是直接动手。这对于熟悉 Blender 但心疼重复操作时间的人来说，是个实实在在的效率工具。

仓库数据

GitHub：ahujasid/blender-mcp
语言：Python
Star 数：22126
当前版本：1.5.5
许可证：MIT

技术架构

整套系统由两部分组成：

Blender 插件（addon.py）：装进 Blender 后，在内部启动一个 socket 服务端，等待外部指令。它不主动往外发数据，只负责接收和执行。
MCP 服务器（src/blender_mcp/server.py）：一个独立 Python 进程，一头通过 MCP（模型上下文协议）和 Claude 通信，另一头通过 socket 把指令发给 Blender 插件。

数据流向是单向的：Claude → MCP 服务器 → Blender 插件 → Blender。架构不复杂，好处是出了问题在哪一步都能快速定位。

已确认的功能集合（基于 README）

主体能力（安装在两个组件中都要支持）

双向通信：Claude 能向 Blender 发指令，Blender 也能返回场景信息给 Claude。
对象操作：创建、移动、旋转、缩放、删除物体。
材质控制：给物体指定颜色或材质，修改对应参数。
场景检查：Claude 能读取当前 Blender 场景里所有物体的属性和位置。
代码执行：Claude 可以在 Blender 的 Python 解释器里执行任意脚本。

v1.5.5 新增

支持腾讯 Hunyuan3D 生成模型。
截取 Blender 视口截图（给 Claude 看，提高指令准确性）。
搜索并下载 Sketchfab 模型。
调用 Poly Haven API 获取资源库。
使用 Hyper3D Rodin 生成 3D 模型。
支持远程主机部署 MCP 服务器。
匿名收集工具执行频率（作者说是完全匿名的，信不信看自己）。

这里面我觉得最有价值的是视口截图。之前 Claude 看不到画面，全靠文字描述猜场景，现在至少能看清你当前在做什么了。

安装详细流程（附踩坑经验）

前置条件

Blender 3.0 及以上
Python 3.10 及以上
uv 包管理器（必装）

README 专门加粗说了“Do not proceed before installing UV”，可见这一步有多关键。

安装 uv

Mac：

brew install uv

Windows（PowerShell）：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

装完后需手动把 uv 加入用户 PATH。我建议装完马上跑 uv --version，确认能识别再继续下一步。

$localBin = "$env:USERPROFILE.localbin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Linux 用户：去安装指南用对应命令。

安装 Blender 插件

从仓库下载最新的 addon.py。
在 Blender 里打开“编辑→偏好设置→插件→安装”，选中 addon.py。
启用插件，在插件设置里能看到它正在监听某个 socket 端口（默认端口由代码决定）。

配置 MCP 服务器

克隆仓库到本地。
在根目录下用 uv 创建虚拟环境并安装依赖。
在 Claude Desktop 的配置文件中添加 MCP 服务器配置项，指向 src/blender_mcp/server.py。
重启 Claude Desktop。

老用户升级时注意：

下载新版 addon.py，替换 Blender 里的旧文件。
在 Claude Desktop 里删除旧 MCP 服务器配置，重新添加。README 说是必须步骤，不照做会遇到连接错误。

实际使用经验

我测试了十几个场景后，总结三条：

指令越具体越好。“创建一个红色立方体，位置 (0,0,0)，尺寸 2x2x2” 比 “做个立方体” 结果稳定。Claude 理解自然语言能力强，但不是读心术。
善用截图反馈。视口截图是 v1.5.5 最实用的新增功能。比如你想让物体“放在合适位置”，先让 Claude 截一张当前视图，再用文字描述调整方向，能减少来回沟通。
复杂任务要拆解。比如做一把木椅：先让 Claude 建座面，再逐条加腿和靠背。一次下太多指令，Claude 可能漏掉某一步，或者把参数算错。这个和给普通程序员提需求是一样的——粒度越细越不容易出错。

项目社区和风险提示

项目没有官方网站。 README 专门用黑体写了：“任何你在网上看到的同名网站都是非官方的，跟本项目没有关系。使用它们风险自负。”
官方交流渠道是 Discord，README 里有链接。
通过 GitHub Sponsors 接受赞助，已有 CodeRabbit 等企业支持者。

我没去第三方网站，所以不清楚那些是否钓鱼或盗版。建议只从 GitHub 仓库下载文件。

总结

BlenderMCP 解决了一个实际痛点：你不用记住 Blender 里每个菜单在哪，只要能把想法讲清楚，Claude 就能帮你操作。它没让 Blender 变得更“智能”，而是让你能用自然语言直接操控它。

如果你常被 Blender 里重复性的基础操作拖慢节奏，这个工具值得一试。安装过程稍微有点绕，但一旦配好，日常使用体验确实流畅。