用说话的方式让 Blender 帮你做 3D:Blender MCP VXAI 完全指南
“
如果你曾经因为 Blender 的按钮太多而头疼,或者只想说一句“给我做一个低多边形城市”就立刻看到结果,这篇文章就是写给你的。下面我会像聊天一样,把 Blender MCP VXAI 的来龙去脉、安装步骤、实际玩法和常见疑问全部摊开讲。整篇内容只基于官方 README,不掺任何外部信息,放心食用。
1. 它到底是什么?
一句话:Blender MCP VXAI 是一座桥,把“人话”翻译成 Blender 能听懂的脚本。
-
你对着电脑说:“在场景中央放一个红色立方体。” -
它立刻在 Blender 里生成红色立方体。
就这么简单。
背后的魔法是 MCP(Model Context Protocol)——一种让大语言模型直接调用本地软件的通用协议。VXAI 只是给 Blender 做的那个“翻译官”。
2. 我为什么要用它?
2.1 省时
传统流程:
-
打开 Blender → 找菜单 → 点 Add → Mesh → Cube → 改颜色 → 保存。
用了 MCP: -
一句话搞定,连手都不用离开键盘。
2.2 降低门槛
非美术出身的程序员也能做 3D 原型;美术同学可以一边喝咖啡一边改场景。
2.3 版本控制更友好
所有操作都是文本指令,天然可回溯,团队里谁改了什么一目了然。
3. 先把环境搭好:一步步来
“
下面的步骤直接复制就能跑,建议边看边做。
3.1 检查电脑
项目 | 最低要求 |
---|---|
Blender | 任意能装插件的版本 |
Python | 3.8 及以上 |
操作系统 | Windows / macOS / Linux 均可 |
3.2 安装 UV(MCP 的启动器)
-
macOS
brew install uv
-
Windows / Linux
pip install uv
装完后,终端输入 uv --version
能看到版本号就说明成功。
3.3 配置 MCP 客户端
你可以把 MCP 想成一个“遥控器”,下面给出两个最常用的客户端配置示例。
3.3.1 Cursor 编辑器
-
打开 Cursor。 -
侧边栏点击 “+ Add new Server”。 -
填表:
字段 | 值 |
---|---|
Name | blender-mcp |
Command | uvx blender-mcp-vxai==1.0.7 |
3.3.2 Claude Desktop
-
菜单:Claude → Settings → Developer → Edit Config。 -
在 claude_desktop_config.json
里追加:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp-vxai==1.0.7"]
}
}
}
3.4 给 Blender 装插件
-
先去 GitHub 下载对应版本的 blender_mcp_addon.py
。-
官方地址模板: https://github.com/VxASI/blender-mcp-vxai/tree/v1.0.7
-
把 v1.0.7
换成你需要的版本号即可。
-
-
打开 Blender → Edit → Preferences → Add-ons → Install from Disk → 选刚下载的 .py
文件。 -
勾选 “Blender MCP” 启用。 -
在 3D 视图按 N
键呼出侧边栏,找到 “BlenderMCP” 标签,点 “Start MCP Server”。
“
小提示:如果侧边栏没有,按一次
N
再按一次T
基本就能刷出来。
4. 用起来的 6 个阶段
官方把完整流程拆成了 6 步,我用自己的话再复述一遍,方便你照着玩。
阶段 | 你应该做什么 | 示例指令 |
---|---|---|
1. 准备底图 | 随便找张参考图,建筑、角色都行 | “这是我的草图。” |
2. 上传 | 把图拖进 MCP 客户端(Cursor/Windsurf/Cline 都行) | 无 |
3. 描述需求 | 用日常语言告诉它你想干嘛 | “照着这张图做 3D,尽量好看。” |
4. 迭代 | 不满意就继续聊 | “把屋顶颜色改成深蓝。” |
5. 导出 | 让它帮你打包文件 | “导出 .glb,再搭个 Three.js 本地服务器。” |
6. 体验 | 浏览器打开,WASD 到处逛 | 无 |
5. 真实对话示例
下面是一段我在 Cursor 里和它的真实聊天记录,你可以感受一下语气有多“像人”。
我:Create this in 3D. I've given you my insane architectural plans—make it as pretty as you can! :)
MCP:收到!先拉一个平面做地基,再按图纸挤出墙体……(中间省略若干技术细节)
我:窗户太小,放大 1.5 倍,顺便换成拱形。
MCP:好,已改。需要加夜景灯光吗?
我:要暖色灯,模拟傍晚。
MCP:已加三盏面光源,色温 3000K。
我:导出 .glb,再建个 Three.js 项目,我想直接在里面走。
MCP:文件已保存到 ./output/arch.glb,npm 脚本已写好,执行 `npm run dev` 即可。
6. 它能做哪些事?
官方列出了 6 大类工具,我把它翻译成“人话”:
工具类别 | 你能怎么使唤它 |
---|---|
物体创建 | “新建一个球”“导入这个 .obj” |
建模 | “把立方体压扁一半”“加表面细分修改器” |
材质 | “把沙发改成皮革、粗糙度 0.3” |
动画 | “在第 30 帧让门旋转 90 度” |
渲染 | “使用 Cycles,采样 128,输出 2K” |
场景管理 | “新建一个 Collection 叫 Props,把椅子扔进去” |
7. 常见问题答疑(FAQ)
“
这部分我模拟了大家在群里最常问的问题,答案均来自官方 README。
Q1:一定要用 1.0.7 吗?
A:不一定。官方说“大多数场景用 1.0.5 就够”,但 1.0.7 是最新,修了一些 bug。版本号可以直接在命令里改。
Q2:装完插件 Blender 报红字怎么办?
A:先确认 MCP Server 有没有在 Blender 里启动;再看终端报错,90% 是端口被占用,重启 Blender 或换端口即可。
Q3:老版本(1.0.3 以下)命令怎么写?
A:
uvx --from blender-mcp-vxai start
Q4:可以离线用吗?
A:可以。模型和脚本都在本地跑,只要 uv 和 Blender 装好即可。
Q5:支持中文指令吗?
A:官方文档没提,但 MCP 本质是把自然语言转 Python,理论上中文也行,实际效果取决于大模型本身。
8. 排错清单(Checklist)
当你觉得“怎么没反应”时,按下面顺序自查:
-
Blender 插件是否勾选启用? -
Blender 侧边栏 MCP 面板是否显示 “Server Running”? -
终端里 uv 命令是否报错? -
客户端配置里的版本号是否和下载的 addon 对应? -
有没有开防火墙把端口拦了?
9. 进阶玩法:把 3D 世界搬进网页
官方给了一条“一条龙”指令,我直接贴过来:
Export this scene in .glb format, then create a ThreeJS app and use this as my world. Set it up as a server to avoid file-loading issues. I want to roam around this world freely—go wild!
执行完你会得到一个本地 dev server,浏览器打开 localhost:3000
就能用 WASD 到处走。技术栈纯粹 HTML + JS,方便二次开发。
10. 参与社区
-
Discord 群: https://discord.com/invite/eswMMBghWs
里面有开发者实时答疑,也能看到别人做的炫酷场景。 -
GitHub 提 Issue:发现 bug 直接甩 log,维护者响应很快。 -
Pull Request:如果你写了更好用的 prompt 模板,欢迎贡献。
11. 写在最后
Blender MCP VXAI 并不是要取代传统建模,而是把“重复劳动”交给 AI,让人的精力集中在创意本身。
当你习惯了“说一句话就能出结果”的流畅感,再回头用鼠标点菜单反而会嫌慢。
希望这篇聊天式的指南能让你少走弯路,早点把脑海里的画面真正搬到屏幕上。
玩得开心,遇到问题群里见!