BlenderMCP 教程：5 分钟把 Claude 接入 Blender，一句话生成完整 3D 场景

BlenderMCP 教程：5 分钟把 Claude 接入 Blender，一句话生成完整 3D 场景

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

输入一句"创建一个现代客厅"，不到一分钟，Blender 视口里出现了沙发、茶几、地毯和灯光。这就是 BlenderMCP 的工作方式：你用自然语言提需求，AI 在 Blender 里动手。

项目速写：AI 与 Blender 3D 之间的桥梁

BlenderMCP 是一个社区开源项目（MIT 协议），通过模型上下文协议（MCP，让大模型统一调用外部工具的协议）把 Blender 接到 Claude 等 AI 助手上。原理一句话：MCP 服务器进程与 Blender 内的插件通过 TCP Socket 通信，AI 把语言指令翻译成 Blender 操作。

核心能力就四样：

• 自然语言创建、移动、缩放、删除 3D 物体
• 场景检查：AI 能读取场景状态，还能对视口截图"看到"当前画面
• 材质控制，以及从 Poly Haven 下载 HDRI、纹理和模型
• 直接在 Blender 里执行 Python 代码（能力最强，也最需要留意安全）

安装 uv 与 Blender 插件，配置 Claude 连接

系统要求：

• Blender 3.0 及以上（4.x / 5.x 更佳），且必须用 GUI 窗口运行，不能用blender -b后台模式
• Python 3.10+
• uv 包管理器（Astral 出品的 Python 包管理工具，比 pip 快，uvx可以免安装直接跑工具）

先装 uv，按平台三选一：

Mac 安装 uv

brew install uv

Windows 安装 uv

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

装完重启终端。Windows 用户注意把%USERPROFILE%\.local\bin加入 PATH。

Linux 安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

不要用pip install uv，那样可能不会生成uvx命令。

然后是 Blender 插件。克隆仓库拿到 addon.py：

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

在 Blender 里依次点 Edit → Preferences → Add-ons → Install...，选择克隆下来的addon.py，启用"Interface: Blender MCP"。插件会在 9876 端口起一个 Socket 服务器，等着 MCP 进程来连。

最后配置 AI 客户端。以 Claude 桌面版为例，编辑claude_desktop_config.json：

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

Windows 下uvx可能是脚本，要写成"command": "cmd", "args": ["/c", "uvx", "blender-mcp"]。改完配置后完全退出并重启客户端。

验证成功：打开 Blender 按N调出侧边栏，在BlenderMCP标签页确认 Host 为localhost、Port 为9876，点Connect to Claude。连接建立后，Claude 工具栏会出现一个锤子图标，说明 Blender 工具已激活。

核心工作流：一句话生成完整客厅场景

下面用一个"从零搭出客厅"的任务走完全程。

在 Blender 插件里建立连接

侧边栏的 BlenderMCP 面板里，Host 和 Port 保持默认，直接点Connect to Claude。此时插件端确认服务器已在监听，MCP 进程随后握手。如果面板显示已连接但 Claude 侧没反应，把第一条指令重发一次——首条指令偶发失败是已知现象。

一句话生成客厅

连接就绪后，在 Claude 对话框里输入：

创建一个现代风格客厅：灰色织物 L 形沙发、直径 80cm 的玻璃茶几、1.8m×2.0m 的米色地毯，地板用浅色木纹材质

十几秒后视口里出现整套家具。背后发生的事：AI 先调用get_scene_info读取当前场景，再通过execute_blender_code在 Blender 里执行 Python 代码，逐个建出物体并赋材质。你不需要懂 Python，AI 负责翻译。

微调细节，让 AI 看着改

接着提第二条：

把茶几移到沙发前 20cm，材质改成深色胡桃木，再在角落加一盏落地灯

这条指令的关键是get_viewport_screenshot：AI 会对视口截图"看一眼"，判断家具相对位置后再动手。所以改完的结果不是盲改，而是它确认过画面的。不满意就继续说，"地毯换灰蓝色"、"落地灯移到右侧"，每轮都是检查 → 修改 → 确认的循环。

进阶配置：三个真正改变体验的细节

🎨开启 Poly Haven，拿到真实光照

默认场景光是平的，画面"塑料感"重。在 BlenderMCP 侧边栏勾选Poly Haven后，对它说"下载一张日落 HDRI 并设置为世界环境"。改前是均匀灰白光照，改后是带方向和色温的真实光影，渲染预览立刻像样。

⏱大任务拆成三步，别指望一句话通吃

一条指令塞进几十件物体容易超时。拆成三段顺序执行：

• 改前：一句"创建完整卧室，包含床、衣柜、书桌、台灯……20 件物品" → 中途超时，场景半成品
• 改后：先"3m×4m×2.8m 房间框架加窗户"，再"床和两个床头柜"，最后"地毯、挂画、暖色灯光" → 每步都稳，中间还能随时插一句调整

💾关掉匿名遥测

默认会收集匿名使用统计（工具名、耗时、版本），敏感内容会在上传前被剔除。不想发任何数据，在客户端配置里加环境变量：

"env": { "BLENDER_MCP_DISABLE_TELEMETRY": "true" }

改完重启客户端，telemetry模块启动时直接跳过上报。细节见 SECURITY.md。

常见坑点与排错

现象：客户端报错spawn uvx ENOENT原因：图形界面客户端不继承你终端的 PATH，找不到uvx解决：终端执行which uvx（macOS/Linux）或where uvx（Windows），把输出的完整路径填进配置的"command"字段，重启客户端。

现象：点了 Connect 没反应，锤子图标不出现原因：MCP 服务器没被拉起来。uvx不要手动运行，是客户端自动启动它的解决：确认插件已启用且端口 9876 没被另一个 Blender 实例占用；首条指令失败就重发一次。

现象：复杂指令执行到一半超时原因：单次 Python 执行时间过长解决：按"结构 → 家具 → 装饰"拆成多条短指令顺序发送，别合并。

现象：Apple Silicon 上报 x86_64 架构错误（cryptography wheel 相关）原因：uvx拉了 x86 版 Python解决：参数改为"args": ["--python", "3.11-aarch64", "blender-mcp"]，强制 arm64。

现象：conda / pyenv 环境下 Python 版本冲突原因：客户端误用了系统里的旧 Python解决：配置中加"--python", "3.11"参数和"UV_PYTHON_PREFERENCE": "only-managed"；仍异常时执行uv cache clean blender-mcp && uvx --refresh blender-mcp清缓存重拉。

它适合谁，边界在哪

BlenderMCP 最顺手的人群是三类：做场景布局和氛围稿的 3D 爱好者、需要快速出方案比选的室内设计师、想练 Blender 又懒得背命令的新手。它生成几何体的方式偏基础（基元加修改器），做生产级高精度模型、复杂拓扑时还是得手动建模或导入高质量资产——把它当"快速铺场 + 灯光材质试验台"最合理。

项目迭代很快，当前版本 1.8.4（以 pyproject.toml 为准），已支持 Sketchfab 模型搜索、Hyper3D 与 Hunyuan3D 生成、视口截图和远程主机（把 MCP 服务器跑在另一台机器上，通过BLENDER_HOST/BLENDER_PORT环境变量指定）。想深入可以看两处：server.py 里所有 AI 可调用的工具定义，addon.py 里 Blender 端的实现。

• 项目仓库（git clone 用）：https://gitcode.com/GitHub_Trending/bl/blender-mcp
• 完整文档与更新日志：README.md
• MCP 服务器源码：src/blender_mcp/server.py
• Blender 插件源码：addon.py
• 安全与遥测说明：SECURITY.md

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