BlenderMCP 安装教程:10 分钟让 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
想让桌子换成红色金属材质,你得去节点编辑器里拖线、翻 bpy 文档、试参数试到眼花。BlenderMCP 就是为填上这个断层做的:它通过 MCP 把你的 AI 客户端(Claude Desktop、Cursor、VS Code 等)连上 Blender,你用自然语言说效果,它来写代码并执行。
它是什么,值不值得试
BlenderMCP 是一个 MIT 协议的开源 Blender MCP 插件,通过 Model Context Protocol 把你的 AI 客户端(Claude Desktop、Cursor、VS Code 等)和 Blender 接在一起。你描述"要什么效果",它生成并执行对应的 Blender Python 代码,再把结果实时反馈给 AI 继续修正。
它替你省掉三件事:
- 不用翻文档查 bpy API 的函数签名
- 不用在着色器节点编辑器里试粗糙度、反射率这些参数
- 不用为布光、摆场景、调相机这类重复性搭建耗时间
准备一下
版本门槛:Blender 3.0+(4.x / 5.x 更稳),Python 3.10+。
把 AI 接进 Blender
装 blender-mcp 服务
macOS 安装 uv:brew install uv;Linux 和 Windows 的安装命令见 README.md 的 Installation 一节。然后打开 Claude Desktop 的配置(Settings > Developer > Edit Config),加入这一段:
{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }不想用 uv 的话,pipx install blender-mcp同样可以。
装插件,点一下 Connect
从仓库下载 addon.py,在 Blender 里走 Edit > Preferences > Add-ons > Install,选中它,启用Interface: Blender MCP。
接着在 3D View 里按N打开侧边栏,切到 BlenderMCP 标签,点Connect to Claude。
AI 客户端里出现锤子图标,说明 Blender 工具已激活,链路打通。
四类它替你干的活
- 你说"现在场景里都有什么?"|它列出所有对象的名称、位置、旋转、缩放,以及相机和灯光参数,不用你逐个点开大纲树
- 你说"在地面上放一张 2x1 米的桌子,配两把椅子"|它创建几何体、对齐位置、命名对象,一次做完
- 你说"把车改成红色金属漆,加三点布光"|它生成金属着色器节点、调粗糙度和反射率,顺手把相机焦距和传感器参数配好
- 你说"下个暖色 HDRI 环境"|它走 Poly Haven 下载 HDRI;说"生成一个小花园侏儒",它调 Hyper3D Rodin 出模型。API Key 存在插件偏好里,重启不丢
从一句提示词到一张图
发一句:"创建一个现代风格的客厅,一张沙发、一个落地灯,暖色灯光。"
AI 先在 Blender 里跑一段 Python,搭出沙发、落地灯和地板;然后调用截屏工具看一眼当前视口,发现灯太暗;再自己调一次灯光强度,重新截屏对比,如此循环,直到画面符合"暖色"为止。核心是它自己看、自己改,你全程不用打开 Python 控制台。
迭代也简单:追加一句"沙发换成皮质,加一盏落地窗",它在现有场景上改,不会重建。核心源码入口是 src/blender_mcp/server.py。
这几个坑先知道
| 现象 | 先查什么 |
|---|---|
| 连不上、AI 里没有锤子图标 | Blender 侧边栏是否点了 Connect;不要手动跑uvx,服务器由 AI 客户端自己拉起 |
报spawn uvx ENOENT | 终端里跑which uvx拿到完整路径,填进配置的"command"字段 |
| 第一条命令失败或超时 | 直接重试一次;复杂任务拆成几个小提示词分步发 |
用pip install uv装的 uv | 换成官方安装脚本,否则可能没有uvx命令 |
另外两条提醒:execute_blender_code是真实执行 Python,动手前存一次档;Apple Silicon 上若报 cryptography 架构错误,在 args 里加"--python", "3.11-aarch64"。
先跑通,再深究
BlenderMCP 替你干体力活,不替你设计。验证链路的最小白动作:先让它"放一张桌子",十分钟内就能确认整条链路是通的;卡住了去看 README.md 的 Troubleshooting 一节。
【免费下载链接】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),仅供参考