BlenderMCP:把 Blender 接上 AI 建模的完整实操指南
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
你有没有被这样的场景卡住:明明想让 AI 帮你做 3D,却不知道如何把大模型接进 Blender 的工作流,只能在聊天框和参数面板之间来回切换,手动调一个材质、挪一个灯光。BlenderMCP 通过模型上下文协议(MCP)把 Blender 与任意 LLM 连起来,用自然语言就能创建和调整 3D 模型。本文带你走完安装、首次连接,再给 4 个由浅入深的提示词示例,全程约 5 分钟。
1. 为什么要把 AI 接进 Blender
Blender 里大量工作是重复性操作:建物体、选材质、布灯光、调相机,每一步都要翻对应的面板,新手很容易在层级里迷路。
它的思路是把工作拆成两半:Blender 一侧由 addon.py 在本地开一个端口,接收并执行指令;AI 一侧由 MCP 服务器 实现 MCP 协议,把大模型的意图翻译成 JSON 命令,通过本地 socket 发给 Blender。
连上之后,AI 能创建和删改物体、调材质颜色、查询场景里的物体灯光相机,还能看视口截图来"看懂"当前画面,形成一个双向回路。
2. 动手前的环境要求
| 项目 | 要求 |
|---|---|
| Blender | 3.0 及以上,推荐 4.x/5.x;必须是正常图形界面(后台模式不可用) |
| Python | 3.10 及以上 |
| uv 包管理器 | 最新版本,负责一键拉起 MCP 服务器 |
| AI 客户端 | Claude Desktop、Cursor、VS Code 等任意支持 MCP 的客户端 |
3. BlenderMCP 安装步骤:Mac 与 Windows
Mac
- 打开终端,运行:
brew install uv这一步装的是 uv,它稍后会替你自动拉取并运行 MCP 服务器。
- 获取插件文件:
git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp克隆下来后,仓库根目录的addon.py就是待会儿要装进 Blender 的插件。
Windows
- 在 PowerShell 中运行官方脚本安装 uv:
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"一行脚本装完,省去手动配置。
- 把 uv 加进用户路径,这样图形界面客户端才找得到
uvx命令:
$localBin = "$env:USERPROFILE\.local\bin" $userPath = [Environment]::GetEnvironmentVariable("Path", "User") [Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")- 同样用
git clone拿到addon.py(地址同 Mac 第 2 步)。
提醒:不要用
pip install uv,那样可能不会生成uvx命令。
4. 第一次连接与最小可用配置
- 打开 Blender,进入"编辑 > 偏好设置 > 插件",点"安装..."选择
addon.py。 - 启用 "Interface: Blender MCP" 插件。
- 在 3D 视口按
N调出侧边栏,切到 BlenderMCP 标签页,点"Connect to Claude"。 - 打开 AI 客户端的 MCP 配置(Claude Desktop:设置 > 开发者 > 编辑配置),加入下面这份最短配置:
{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }- 完全退出客户端再重新打开,让配置生效。
界面上只需要关心那个 Connect 按钮,旁边的 Poly Haven 复选框是可选的资源库开关,第一次可以不勾。注意不要在终端里手动执行uvx,服务器会由客户端自己拉起;连接成功后客户端会出现一个小锤子图标,说明 Blender 工具已就绪。
5. 上手实战:4 个由浅入深的提示词示例
示例 1:创建基础物体
- 需求:先放一个物体,验证链路通了
- 指令:「在场景中央创建一个红色金属质感的球体」
- 效果:AI 建好球体并应用红色金属材质,视口里立即可见
示例 2:查看场景状态
- 需求:动手前搞清楚当前场景里有什么
- 指令:「列出当前场景中所有的物体、灯光和相机」
- 效果:返回一份结构化的场景清单,为后续操作提供上下文
示例 3:局部材质调整
- 需求:只改一个物体的外观,不重建模型
- 指令:「把这辆车改成红色金属质感」
- 效果:AI 定位到该物体,只修改材质参数,不动其他对象
示例 4:完整场景 + 资源集成
- 需求:一个有氛围感的完整低多边形场景
- 指令:「创建一个低多边形地牢,里面有一条守着金罐的龙」
- 效果:AI 自行规划布局和灯光并逐步搭建;若勾选了 Poly Haven,还能直接拉取 HDRI 和现成模型
6. 个性化调整:环境变量与可选集成
Blender 和 MCP 服务器不在同一台机器时(Docker、WSL、远程主机),在客户端配置的env里调整:
| 变量 | 默认值 | 说明 |
|---|---|---|
| BLENDER_HOST | localhost | 插件所在主机地址,Docker 内一般填 host.docker.internal |
| BLENDER_PORT | 9876 | 连接端口,需与插件端一致 |
| BLENDER_MCP_DISABLE_TELEMETRY | 关 | 设为 true 关闭匿名使用统计 |
可选集成按需开启,不装也能跑通基础流程:
| 集成 | 开启方式 |
|---|---|
| Poly Haven | 侧边栏勾选,AI 可下载 HDRI、纹理和模型 |
| Sketchfab | 填入 API Key,搜索并导入模型 |
| Hyper3D Rodin | 填入 API Key,用 AI 生成 3D 模型(免费额度有每日上限) |
| Hunyuan3D | 在 Blender 插件偏好里填密钥,用于文生 3D |
较新版本陆续加入了 Hunyuan3D 支持、视口截图、Sketchfab 搜索等功能;从旧版升级时,重新导入最新addon.py并在客户端里删除重加 MCP 服务器即可。
7. BlenderMCP 常见问题速查
| 现象 | 原因 | 处理 |
|---|---|---|
| 第一条指令就超时 | 首次连接握手不稳 | 直接重试一次,通常就能通过 |
| spawn uvx ENOENT | 图形界面客户端找不到 uvx | 执行which uvx(Windows 用where uvx),把完整路径填进配置的 command |
| 提示连不上 Blender | 插件服务没启动或主机/端口不一致 | 在侧边栏确认已点 Connect,核对 BLENDER_HOST 与 BLENDER_PORT |
| Apple Silicon 报 x86_64 构建错误 | uv 选错了 Python 架构 | 在 args 里加上--python 3.11-aarch64 |
| 复杂场景请求超时 | 单次任务量太大 | 拆成多条小指令,按顺序分步下发 |
| 改了配置仍无效 | 客户端没有完全重启 | 彻底退出 AI 客户端后重新打开 |
8. 安全边界:它的能力边界在哪里
execute_blender_code会在 Blender 里执行任意 Python,理论上可以把场景改成任何样子,做大动作前建议先存盘。- 开启资源库集成后,AI 会下载并导入模型、纹理和 HDRI,留意素材授权和磁盘占用。
- 项目默认会发送匿名使用统计(工具名、成功与否、版本信息),介意的人可以用上面的环境变量或插件偏好里的开关关掉。
一句话总结:BlenderMCP 让一句自然语言就能真正操作 Blender,装好插件、配好服务器、点下 Connect 就能开工。随着 MCP 生态和 3D 资产库继续扩张,"AI 当建模搭子"这条路只会越走越顺。
【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考