BlenderMCP 完整指南：自然语言驱动 AI 3D 建模-育师

BlenderMCP 完整指南：自然语言驱动 AI 3D 建模

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

BlenderMCP 是一款通过 MCP（模型上下文协议）把 Blender 连上 Claude 的开源工具，在对话里用自然语言就能让 AI 建模、改材质、找素材。适合 3D 新手和想加速场景搭建的设计师。

搭一个场景往往要反复拖鼠标建物体、翻材质库调参数、再去外部网站找模型素材，每一步都得自己动手。BlenderMCP 把这三件事接进对话窗口：你描述想要什么，Claude 通过 MCP 连接 Blender 直接在 3D 场景里动手完成。一句话出整个场景，试错成本从"重做"变成"改一句指令"。

整个过程就三个环节：装 uv → 装 Blender 插件 → 配 Claude，系统要求是 Blender 3.0 及以上（推荐 4.x / 5.x）、Python 3.10 及以上。

装 uv 包管理器：macOS 执行brew install uv；Windows 在 PowerShell 中执行powershell -c "irm https://astral.sh/uv/install.ps1 | iex"，并把%USERPROFILE%\.local\bin加入 PATH。不要用pip install uv，它可能不会生成uvx命令。
装 Blender 插件：克隆仓库获取插件文件：
```
git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp
```
打开 Blender，进入编辑 > 偏好设置 > 插件 > 安装…，选择仓库里的 addon.py（它是 Blender 侧插件入口），然后启用"Interface: Blender MCP"。
配 Claude 客户端：打开 Claude > 设置 > 开发者 > 编辑配置，在claude_desktop_config.json里加一段 blender 配置（内容见下文"配置与进阶"），改完完全退出并重启客户端。
点 Connect：在 Blender 里按N打开 3D 视图侧边栏，切到BlenderMCP标签页，点击Connect to Claude。连接成功后 Claude 一侧会显示小锤子图标，表示 Blender 工具已激活。

🧊管模型：用指令创建、移动、缩放、删除物体，不用打开任何菜单。AI 还能拍视口截图"看"你当前的场景，改起来更有针对性。

🎨改材质：给对象指定颜色、金属度等属性，或从素材库把纹理贴到指定物体上，一句"改成红色金属"就生效。

🔍看场景：随时让 AI 汇报场景状态——有哪些物体、灯光、相机，等于给对话开了一个场景检查清单。

🐍跑代码：Claude 可以直接在 Blender 里执行 Python 代码处理批量或精细操作。这个工具权限很大，用之前记得保存工程。

🗂️接素材库：从 Poly Haven 拉 HDRI、纹理和 3D 模型，从 Sketchfab 搜索并导入现成模型，还可以用 Hyper3D Rodin 和 Hunyuan3D 生成 AI 模型，不用离开 Blender 找素材。

服务端实现集中在 src/blender_mcp/server.py，即 MCP 服务与 Blender 插件之间的桥。

连上之后直接说人话就行，下面是几类典型用法：

如果结果不对，接着补充指令继续改即可，整个过程都在对话里完成。

最小配置就是claude_desktop_config.json里的这一段，uvx会由 Claude 客户端自动拉起 MCP 服务，无需手动启动：

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

默认连接本机 9876 端口。如果 Blender 和 MCP 服务不在同一台机器（Docker、WSL 或远程主机），用两个环境变量指定地址：

export BLENDER_HOST='host.docker.internal' export BLENDER_PORT=9876

也可以在 JSON 配置的"env"字段里写这两个变量，效果相同。

点 Connect 后没反应→ 确认 BlenderMCP 侧边栏里插件服务处于运行状态；不要手动去终端跑uvx，服务应由 Claude 客户端自动启动。
报 spawn uvx ENOENT→ 图形界面客户端不继承终端 PATH，用which uvx（macOS/Linux）或where uvx（Windows）拿到完整路径，填进配置的"command"字段。
复杂操作超时→ 把大需求拆成多个小步骤，按顺序分条下达，第一条指令失败时再试一次通常就好。
以上都试过还不行→ 终极手段：把 Claude 客户端和 Blender 里的 MCP 服务都重启一遍，重新点 Connect。