MCP for Blender 上手指南:三步把 AI 接入 Blender,一句话搭出 3D 场景
【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender
会写“把沙发改成红色金属”这种话,就能让 AI 替你操作 Blender 3D。MCP for Blender 是一个开源社区插件(MIT 协议),通过 Model Context Protocol(MCP,可理解为 AI 客户端与外部工具之间的通信协议)把 Claude Desktop、Cursor、VS Code 等 AI 助手和 Blender 连起来。你描述效果,它生成并执行 Blender Python 代码,再实时回看视口、把结果反馈给 AI 继续修正。本文覆盖安装、配置与常见报错,按最小验证路径走一遍,十分钟即可确认整条链路。
痛点:从“要一张红色金属桌子”到成图,中间隔着什么?
设想这样一个需求:地面上放一张 2x1 米的桌子,配两把椅子,再打一套暖色三点布光。没有 AI 时,它意味着三块机械劳动:自己翻 bpy 文档、在节点编辑器里拖线试参数、反复摆场景改相机的重复搭建。
MCP for Blender 把分工切得很干净,它只干“体力活”:
- 你负责:用一句大白话说明要什么效果;
- 它负责:生成 bpy 代码、创建并对齐对象、调整材质与灯光,还会自己看视口确认结果是否符合描述;
- 它明确不做:创意决策。风格取舍、画面“好不好看”,仍然由你拍板。
两个边界也先说清楚:这是第三方项目,与 Blender 官方基金会无关;另外 AI 会在你的 Blender 里真实执行 Python 代码,动手前先存一次档是硬性习惯。
安装前检查:版本门槛与依赖清单
硬门槛只有一个,外加两个依赖:
| 依赖 | 门槛 | 说明 |
|---|---|---|
| Blender | 3.0+ | 4.x / 5.x 更稳 |
| Python | 3.10+ | 供 MCP 服务端运行 |
| uv(Python 包管理器) | 必装 | 提供uvx命令;macOS 执行brew install uv即可,Linux 与 Windows 的安装方式见 README.md 的 Installation 一节 |
还有两条前置小提醒:
- uv 要用官方安装脚本装,别用
pip install uv,否则可能没有uvx命令; - 不想走 uv 路线的话,
pipx install blender-mcp同样可行。
Blender MCP 接入流程:客户端登记、插件启用、链路验证
全程三个动作:一个在 AI 端,一个在 Blender 端,一个用来验证两端。
第一步:把 uvx 服务端登记到 AI 客户端
以 Claude Desktop 为例:Settings → Developer → Edit Config,在配置文件中加入这段:
{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }💡 PyPI 包名现已更名为
mcp-for-blender,旧名blender-mcp照常可用,已有配置无需改动。
这里有个关键认知:不要手动在终端跑uvx。MCP 服务器由 AI 客户端按需拉起,自己先跑一遍反而是常见的故障源。
第二步:安装并启用 Blender 插件
从仓库下载 addon.py,然后在 Blender 里:
- Edit → Preferences → Add-ons → Install,选中该文件;
- 勾选启用 “Interface: Blender MCP”(新版界面中显示为 “Interface: MCP for Blender”)。
第三步:侧边栏启动服务,验证链路
在 3D View 中按N打开侧边栏,切到插件标签页,点击Connect to Claude(部分版本显示为Start MCP Server,插件在 Blender 打开时也会自动启动服务)。回到 AI 客户端,看到锤子图标出现,即代表 Blender 工具组已激活,链路打通。🪄
接通之后能干什么:三个“你说→它做”实例
高频能力可以归成四类,规律一致:你说 → 它做。
| 你说 | 它做 |
|---|---|
| “现在场景里都有什么?” | 列出全部对象的名称、位置、旋转、缩放,外加相机与灯光参数,不必逐个点开大纲树 |
| “在地面上放一张 2x1 米的桌子,配两把椅子” | 创建几何体、对齐位置、命名对象,一次做完 |
| “把车改成红色金属漆,加三点布光” | 生成金属着色器节点,调粗糙度与反射率,顺手配好相机焦距和传感器参数 |
资源与生成是另一块大头:说“下个暖色 HDRI 环境”,它走 Poly Haven 下载;说“生成一个小花园侏儒”,它调 Hyper3D Rodin 出模型。各类 API Key 都存放在插件偏好里,重启 Blender 不会丢。
从一句提示词到成图:AI 的自检闭环
拿最经典的例子练手:
“创建一个现代风格的客厅,一张沙发、一个落地灯,暖色灯光。”
幕后过程是这样的:AI 先在 Blender 里执行一段 Python,把沙发、落地灯和地板搭出来,接着调用截屏工具查看当前视口;灯光偏暗?它自己调整强度,再截一张对比,循环往复,直到画面确实称得上“暖色”。你全程不用打开 Python 控制台,最后保存 .blend 文件即可。
迭代成本同样低:接着补一句“沙发换成皮质,加一盏落地窗”,它是在现有场景上修改,而不是推倒重建。想追实现细节,核心代码在 src/blender_mcp/,服务端入口是 server.py。
Blender MCP 常见报错与排障速查
遇到问题先对照下表,顺序是“现象 → 先查什么”:
| 现象 | 先检查什么 |
|---|---|
| 连不上,AI 客户端里没有锤子图标 | 先到 Blender 侧边栏确认是否点了 Connect;服务器应由 AI 客户端拉起,别手动执行uvx |
报spawn uvx ENOENT | 终端执行which uvx找到它的完整路径,再把这个路径填进配置的"command"字段 |
| 第一条命令失败或超时 | 首条命令经常失手,直接重试一次;大任务拆成几段小提示词分步发送 |
装完 uv 却找不到uvx | 多半是用了pip install uv,换回官方安装脚本(macOS 即brew install uv) |
⚠️ 再记两条边界事项:
execute_blender_code会真实执行 Python,让它碰正式场景之前,先保存一份 .blend;- Apple Silicon 上遇到 cryptography 架构报错,在配置的
args里加"--python", "3.11-aarch64"。
十分钟验证链路:最小验证路径与进阶方向
不想一上来就奔大任务,就先发最小提示词:
“放一张桌子到场景里。”
视口里桌子出现、客户端里锤子图标在线,整条链路就算通了,通常十分钟以内。✅
中途卡住时,优先翻 README.md 的 Troubleshooting 一节;提示词写法上,一次只做“摆一个物体 / 改一种材质”这种粒度,比一口气丢整段需求更稳。
这套工具的价值,在于补上“知道要什么效果”与“会写对应 Blender 代码”之间的断层——创意判断仍归你,布光、摆场景、改相机这类机械活交给 AI。链路验证之后,可以逐步过渡到材质调参、灯光布光和资源生成等更复杂的玩法。
【免费下载链接】mcp-for-blenderCommunity plugin to control Blender 3D with any LLM of your choice. Not affiliated with the official Blender Foundation.项目地址: https://gitcode.com/GitHub_Trending/bl/mcp-for-blender
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考