5分钟把Blender连上Claude：BlenderMCP AI 3D建模手把手完整教程-平芜编程栈

5分钟把Blender连上Claude：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 就会建出模型、贴上材质、摆好灯光。本文从装环境到跑通第一次文字生成，一步步带你走完，零基础跟着做即可。

这个工具替你做了什么：用MCP连接把AI 3D建模接入Blender

BlenderMCP 用模型上下文协议（MCP）把两端接起来：Blender 一侧是一个小插件，在本地 9876 端口跑一个 socket 服务；AI 一侧是客户端（比如 Claude）自动拉起的 MCP 服务器。接通之后，你的文字指令就会变成 Blender 里的实际操作：建物体、改材质、跑脚本、查场景。

看一个"输入→输出"的例子：

输入："做一辆红色低多边形小车，打一盏摄影棚光"
输出：视口里出现一辆红色金属材质的小车；再发一句"车身再亮一点"，它会接着改

两个核心文件分工很简单：

addon.py：跑在 Blender 里，负责接收并执行指令
src/blender_mcp/server.py：MCP 服务器，把 AI 的工具调用翻译成 Blender 操作

环境搭建与首次连接：安装uv并配置MCP服务器 🔧

先备齐三样东西：Blender 3.0 以上（推荐 4.x，用普通窗口模式打开，不要用后台模式）、Python 3.10 以上（Blender 自带，一般不用另装）、uv 包管理器。

1. 安装uv包管理器

uv 用来运行 MCP 服务器，按系统各跑一条命令：

# 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"。注意不要用pip install uv，它常常不会生成uvx命令。装好后在终端敲uvx --version，能输出版本号就说明这步做对了。

2. 配置AI客户端并安装Blender插件

打开 Claude 桌面客户端，进入设置 → 开发者 → 编辑配置，在claude_desktop_config.json里加上这段：

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

保存后完全退出客户端再重新启动。如果客户端报spawn uvx ENOENT，说明图形界面找不到 uvx：在终端跑which uvx（Windows 用where uvx）拿到完整路径，把它填进command字段。

然后在 Blender 里装插件。先克隆仓库拿到插件文件：

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

在 Blender 中依次点编辑 → 偏好设置 → 插件 → 安装…，选中克隆目录里的addon.py，启用"Interface: Blender MCP"。做对长什么样：按N打开 3D 视图侧栏后，能看到一个BlenderMCP选项卡。

接下来验证连接：在侧栏的 BlenderMCP 选项卡里，主机和端口保持默认的localhost和9876，点Connect to Claude：

判断连上了没有，看两个信号：侧栏显示已连接状态；Claude 对话窗口的工具列表旁出现一个锤子图标。出现锤子，说明 AI 现在可以操作 Blender 了。

第一次生成：文字到模型

直接在 Claude 对话框里打指令。两个可以直接复制使用的例子：

做一个低多边形地牢：石质地面、几根石柱，角落里有一条龙守着一堆金币

把选中的立方体变成一辆车：红色金属车身、黑色车轮，再加一盏柔和的棚灯

写法提示：好的描述一般带三要素——做什么（物体）、什么样子（材质/颜色）、怎么摆（数量/尺寸/位置）。比如"3行4列的石柱"就比"几根柱子"稳定得多。

发出去之后留意视口：AI 会先调用get_scene_info查看当前场景，再一步步执行。结果不理想不要重头再来，直接发一句修正的话，比如"把相机转成45度等轴视角"，它会接着改。

素材与细节增强：用好三个内置素材源 🎨

侧栏里有几个勾选框，各对应一个素材源，职责不同：

Poly Haven：免费的 HDRI 环境光、PBR 纹理和 3D 模型，用来搭真实感场景。勾上即可用
Hyper3D Rodin / Hunyuan3D：AI 文字生成 3D 资产，专门做模型库里找不到的东西，比如"一个抱着花的花园侏儒"
Sketchfab：从大模型库搜索并导入用户上传的真实模型

什么时候用哪个：搭场景、铺地面、打光，用 Poly Haven 就够；AI 自己建不出某个具体物件时，让它调用 AI 生成；想要真实道具（车、家具、武器），让它去 Sketchfab 搜。

后两者需要 API Key：在 Blender 的编辑 → 偏好设置 → 插件 → Blender MCP 里填入对应密钥（Hyper3D 有免费试用，每天有额度上限）。密钥存好后重启也不丢。

你也可以点名用某个素材："把 Poly Haven 上'风化木头'的纹理贴到地面"，插件会自动完成搜索、下载和映射。

效果调优与常见问题

让生成结果更准，记住三个习惯：

大任务拆小步——"建一座中世纪小镇"容易超时，按"先地面墙体、再建筑、后道具"的顺序分几次说
描述给数字——数量、尺寸写具体，AI 少发挥，结果更可控
先让AI看再改——视口截图是内置能力，修正前先让它"看一下当前画面"，再提要求，改起来更准

生成出问题时对照这张表

现象	可能原因	处理办法
客户端报`spawn uvx ENOENT`	图形界面找不到 uvx	终端跑`which uvx`拿完整路径，填进配置`command`字段
点 Connect 一直转圈无响应	Blender 端服务没在监听	确认插件已启用、Blender 是窗口模式而非后台模式
第一条指令总是不生效	连接后的首个命令经常失败	不用排查，把同一条指令再发一次即可
复杂场景做到一半中断	单次任务太大	拆成 2~3 条小指令按顺序执行