BlenderMCP 上手指南：让 Claude 替你搭 3D 场景

BlenderMCP 上手指南：让 Claude 替你搭 3D 场景

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

你在 AI 对话框里敲下"做一个地牢，里面有条龙守着金子"，几分钟后 Blender 里真的冒出一个摆好龙和金堆的地牢场景——这就是 BlenderMCP 带来的 AI 3D 建模工作流：这个开源插件通过模型上下文协议（MCP）把 Blender 接入 Claude 等大语言模型，新手也能靠自然语言搭出完整 3D 场景。

🔌 拆解原理：Claude 如何控制 Blender

一句话讲清链路：BlenderMCP 在 Blender 和 Claude 之间开了一条实时对话通道——Claude 发出结构化指令，Blender 执行并把结果回传，双方都能看到对方反馈。这条通道由三处接力完成：

第一段：插件里开 socket

addon.py 在 Blender 内部起一个 TCP socket 服务器（默认端口 9876），负责收指令并在当前场景里执行：建、移、删物体，改材质和颜色，还能把视口截图回传，让 Claude"看见"现场。

第二段：MCP 服务端做翻译

src/blender_mcp/server.py 实现了 MCP 协议，是对话的另一端：它把 LLM 客户端的工具调用翻译成 socket 指令发给 Blender，再把执行结果送回模型，Claude 由此知道"刚才做了什么"。

第三段：顺带接上资源库

服务端还对接了 Poly Haven、Sketchfab、Hyper3D Rodin、Hunyuan3D 等资源与生成平台，一句话就能触发下载 HDRI、纹理或 3D 模型，也可以直接 AI 生成新模型。

🚀 跑通：四步装好并连上 Blender MCP

系统要求：Blender 3.0 以上（推荐 4.x）、Python 3.10 以上，外加 uv 包管理器。

1. Mac 上先装 uv 并克隆仓库，插件文件addon.py就在仓库根目录（Windows 用户可改用仓库 README 里的 PowerShell 脚本装 uv）：

brew install uv git clone https://gitcode.com/GitHub_Trending/bl/blender-mcp

2. 在 Claude（或任意 MCP 客户端）的配置里加一个 blender 条目，让客户端用uvx自动拉起服务端：

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

3. 在 Blender 的"编辑 > 偏好设置 > 插件"里安装addon.py，启用 "Interface: Blender MCP"。
4. 按N打开 3D 视图侧边栏，切到 BlenderMCP 标签页，点 Connect to Claude：

看到 Claude 对话里出现锤子图标，链路就通了，直接开口让它搭东西。

🎬 玩起来：三个 AI 3D 场景生成用例

• "Create a low poly dungeon with a dragon guarding gold" → Blender 建出带龙和金堆的地牢场景，相机和灯光一步到位。
• "用 Poly Haven 的 HDRI、岩石和植被做个海滩" → 自动下载 HDRI 与素材并应用到场景，海滩氛围直接成型。
• "把这辆车改成红色金属" → 车辆材质立刻切换成红色金属质感，不用打开材质编辑器。

⚠️ 避坑：调优与安全必须知道的事

• 别在终端手动跑uvx blender-mcp：服务端由客户端拉起；且首条指令常连不上，原样重发一次即可。
• 连接超时或无响应：确认插件里已 Connect，再重启 MCP 客户端和 Blender；请求太复杂就拆成小步骤分着发。
• Docker / WSL 下 Blender 不在本机，需在 env 里用BLENDER_HOST（如host.docker.internal）和BLENDER_PORT指到真实地址。
• execute_blender_code会在 Blender 里执行任意 Python，玩之前先存文件；不想发匿名遥测就设BLENDER_MCP_DISABLE_TELEMETRY=true。

回到开头那个场景：你在聊天框里敲下的不再是描述，而是 Blender 里的实物。跑通这一圈之后，不妨再换几个场景指令试试，也去仓库看看最新 release 又解锁了什么。

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