BlenderMCP 如何把 AI 接到 Blender：用自然语言生成 3D 解剖模型的完整流程

BlenderMCP 如何把 AI 接到 Blender：用自然语言生成 3D 解剖模型的完整流程

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp

BlenderMCP 是一个把 AI 助手（如 Claude）接到 Blender 3D 的桥梁工具。它基于 MCP（模型上下文协议，可以理解为一套让 AI 与外部软件互相通信的标准），让你直接用一句话创建、移动、上色 3D 物体，不用先学会 Blender 的全部操作。适合医学教学者、解剖演示制作者和 3D 新手用来做解剖学可视化。

一、一个场景看懂它：准备一堂解剖课演示

想象你要给一堂解剖课前准备一个心脏演示模型。没有这个工具的流程是：打开 Blender，新建一个球体，一点点调出心室和血管的轮廓，再去材质面板里调颜色，最后摆好灯光、调好相机，一个下午就这么过去了，期间任何一步卡住都得自己排查。

装上 BlenderMCP 之后，流程变成：你在聊天框里打字，AI 把指令翻译成 Blender 能执行的操作，模型、材质、灯光实时出现在视口里。整个通信过程由 src/blender_mcp/server.py 里的连接桥接完成——AI 端跑一个 MCP 服务器，Blender 端跑一个插件，两者通过 TCP 端口（默认 9876）交换 JSON 指令。你在 Blender 侧边栏（按 N 键呼出）的 BlenderMCP 选项卡里点击 "Connect to Claude" 即可看到连接状态：

二、连接准备：安装 uv 并配置 AI 客户端

准备工作分三块，全程不到 15 分钟。

1. 环境要求：Blender 3.0 以上（建议 4.x / 5.x，且要用正常 GUI 会话，不要用后台模式）、Python 3.10 以上、uv 包管理器。

2. 安装 uv（pip install uv不行，它不会生成uvx命令）：

# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh

Windows 用户在 PowerShell 执行powershell -c "irm https://astral.sh/uv/install.ps1 | iex"，然后把%USERPROFILE%\.local\bin加入 PATH。

3. 装插件、配客户端。把仓库里的 addon.py 通过 Blender 的"编辑 > 偏好设置 > 插件 > 安装"装入并启用 "Interface: Blender MCP"。然后在 Claude 桌面版的配置（Settings > Developer > Edit Config）里加入：

{ "mcpServers": { "blender": { "command": "uvx", "args": ["blender-mcp"] } } }

Cursor、VS Code 等客户端写法类似，注意同一时间只在一个客户端里跑 MCP 服务器，别两个同时开着。

三、一句话生成一个模型

连接成功后，AI 不仅能执行指令，还能查询场景信息、截取视口截图来"看到"当前画面，所以你可以像跟同事交代活儿一样连续对话。下面用心脏模型走一遍三个典型场景。

1. 用一句话生成心脏解剖模型

你想要什么：一个带左右心室、上下腔静脉轮廓、按解剖配色区分左右侧的心脏基础模型。

你对 AI 说什么：

创建一个人类心脏模型：包含左右心室、心房和主动脉、肺动脉、上下腔静脉的粗略轮廓；左侧心腔用鲜红色、右侧用暗紫色区分含氧与静脉血；加一盏主光，并把相机调到正面略偏右的视角。

得到什么：视口里出现一组命名清晰、颜色分区明确的物体，不满意就继续追加"把左心室再放大 10%"，AI 会基于当前场景状态做增量修改。

2. 如何给模型配上医学风格材质与灯光

你想要什么：干净的教学级画面，背景不抢戏。

你对 AI 说什么：

从 Poly Haven 找一个中性影棚 HDRI 并设为环境光照，把心脏表面改成微哑光质感，再加一盏柔光补上暗部。

得到什么：AI 会调用 Poly Haven 资产下载能力，把 HDRI 拉进场景并挂上材质。Poly Haven 功能需要在 BlenderMCP 侧边栏里先勾选启用。

3. 如何搜索并导入现成的心血管 3D 模型

你想要什么：不想从零建模，直接用社区里现成的高精度模型。

你对 AI 说什么：

在 Sketchfab 上搜索 "anatomical heart" 模型，给我几个可选结果，选第一个导入场景并缩放到合适大小。

得到什么：AI 先列出搜索结果供你确认，再下载并导入。想要 AI 直接"生成"一个模型的话，还可以用 Hyper3D Rodin 或 Hunyuan3D 的文生 3D 能力，对应的 API 密钥在 Blender 偏好设置的 Blender MCP 插件页填写即可持久保存。

四、容易踩的坑

为什么点 Connect 之后第一条指令总是失败

这是已知现象：连接刚建立时第一条命令经常失败，直接再发一次同样的指令就好。另外别手动在终端跑uvx，MCP 服务器是由 AI 客户端自动拉起的，你只负责把 Blender 那边的服务器点起来。

为什么客户端报 spawn uvx ENOENT

图形界面程序不会继承你终端里的 PATH，所以它找不到uvx。用which uvx（Windows 是where uvx）查一下完整路径，把这个绝对路径填进配置的"command"字段，改完配置后要彻底退出客户端再重开。

端口对不上怎么办

插件端和 MCP 服务器端默认都走 9876，如果你改过其中一端，另一端的BLENDER_PORT要同步修改；Docker / WSL 环境下还要注意BLENDER_HOST要指向对端能访问到的地址（比如 WSL2 里访问 Windows 的 Blender 可试127.0.0.1或宿主机 IP）。

为什么复杂指令会超时

一条指令让 AI 干太多事就容易超时。把大目标拆成几条按顺序的小指令，比如先建几何、再调材质、最后打光，稳定性和可回退性都更好。

Python 版本冲突怎么解

配置里固定版本再清缓存：

"args": ["--python", "3.11", "blender-mcp"], "env": { "UV_PYTHON_PREFERENCE": "only-managed" }

然后执行uv cache clean blender-mcp && uvx --refresh blender-mcp。

五、适合谁用，下一步做什么

这个工具对三类人最实用：需要频繁产出解剖演示材料的医学教师、想跳过 Blender 学习曲线直接出 3D 内容的创作者，以及任何"会打字但不会建模"的新手。它的边界也很清楚——生成的是示意性几何，不是基于真实影像的精确重建，教学示意够用，临床用途请自行判断。

建议的下一步：先按第二节的步骤把连接跑通，用第三节的第一条心脏指令练手，跑通之后再逐步尝试 Poly Haven 灯光和 Sketchfab 导入。动手之前记得保存好文件——AI 可以执行任意 Python 代码，误操作时你总希望有备份 😊

【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp