1. 为什么我要把 Blender 接到 AI 上BlenderMCP 解决的真实痛点如果你用过 Blender 做过稍微复杂一点的场景应该懂那种感觉脑子里已经想好了画面但手上还在跟快捷键、修改器、材质节点较劲。尤其是做原型阶段一个地牢场景从建墙体、摆火炬、调材质到打光熟练工也得大半天。BlenderMCP 这个开源项目想干的事就是让你用自然语言直接指挥 Blender把「描述需求」和「软件操作」之间的那层墙拆掉。BlenderMCP 全称是 Blender Model Context Protocol它通过 MCP 协议把 Blender 和一个支持 MCP 的 AI 客户端连起来。你在对话里说「创建一个低多边形地牢中间放一个金罐旁边站一条龙」AI 会把它拆成一系列 Blender 能执行的 Python 操作通过 Socket 发给 Blender 插件插件在场景里真的把对象建出来。整个过程是双向的AI 能读取当前场景信息也能截图看视口所以它能根据实际结果调整下一步动作而不是盲写代码。它适合谁我总结了三类一是独立开发者或小团队需要快速出游戏场景原型二是做产品可视化、建筑预可视化的设计师想省掉重复建模时间三是刚学 Blender 的新手想通过自然语言先跑通「场景搭建 → 材质 → 灯光 → 导出」的完整链路再回头补操作细节。核心检索词就三个BlenderMCP、AI 辅助 3D 建模、MCP 协议连接 Blender。下面我从环境准备到一次完整建模任务把可复制的配置和验证动作都写清楚。2. 前置准备BlenderMCP 服务端与 Blender 插件联动配置这一节是整篇的地基配不好后面全白搭。BlenderMCP 的架构分两块一块是 MCP 服务端负责和 AI 客户端通信一块是 Blender 插件负责在 Blender 内部执行命令。两者通过本地 Socket 通信默认端口 9876。你需要准备的东西不多但版本要对。环境要求我实测下来是这样的Blender 3.0 以上建议 4.x插件兼容性更好Python 3.10以及一个支持 MCP 的 AI 客户端。包管理推荐用 uv它比 pip 在隔离环境上省心。macOS 上装 uv 直接brew install uvWindows 装完之后要把C:\Users\你的用户名\.local\bin加到系统 Path 里否则命令行找不到 uvx。装完验证一下uv --version uvx --version两个都能输出版本号才算过。接着装 BlenderMCP 本体uv pip install blender-mcp注意这里装的是 MCP 服务端不是 Blender 插件。插件是单独一个addon.py文件需要从项目仓库下载。下载后在 Blender 里操作Edit Preferences Add-ons点右上角Install...选中addon.py然后在列表里搜索Blender MCP勾选启用。启用后按N键打开 3D 视图侧边栏能看到BlenderMCP标签页里面有Connect to Claude按钮先别急着点等 AI 客户端配置好再连。AI 客户端这边以 Claude Desktop 为例配置文件路径在 macOS 是~/Library/Application Support/Claude/claude_desktop_config.jsonWindows 是%APPDATA%\Claude\claude_desktop_config.json。写入下面这段{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }保存后重启客户端。这里有个坑我踩过如果你之前装过其他 MCP 服务mcpServers里要合并写不能覆盖否则原来的服务会消失。配置完客户端启动时会自动拉起blender-mcp这个进程它监听本地端口等 Blender 插件来连。3. 可复制配置MCP 连接参数、插件安装与模型 ID 三件套上一节讲了「装什么」这一节讲「怎么配得对」。BlenderMCP 的配置核心就三样Base URL本地 Socket 地址、Key这里不是 API Key而是连接握手、Model IDAI 客户端侧选的模型。很多人卡在第一步就是因为把这三样搞混了。先看 MCP 服务端的完整配置。如果你用的是支持自定义 MCP 的客户端配置结构大致如下路径和字段名要和你客户端文档一致{ mcpServers: { blender: { command: uvx, args: [blender-mcp], env: { BLENDER_MCP_HOST: 127.0.0.1, BLENDER_MCP_PORT: 9876 } } } }BLENDER_MCP_HOST和BLENDER_MCP_PORT是服务端监听地址默认就是本地 9876。Blender 插件那边连接时用的也是这个端口两边必须一致。如果你本机 9876 被占用改这里的同时Blender 插件侧边栏里也有对应的端口输入框要同步改。Blender 插件安装步骤再细化一遍因为这是最容易出错的地方从项目仓库下载addon.py放到一个你不会随手删掉的目录比如~/blender-mcp/addon.py。打开 BlenderEdit Preferences Add-ons Install...选中该文件。在搜索框输入Blender MCP勾选启用。如果没出现检查 Blender 版本是否低于 3.0。按N打开侧边栏切到BlenderMCP标签确认Port是 9876和上面配置一致。关于 Model IDBlenderMCP 本身不绑定模型它依赖你 AI 客户端里选的模型。你在客户端里选哪个模型就决定了「谁在指挥 Blender」。选模型时优先选支持长上下文和代码生成的因为 Blender 操作最终会转成 Python 代码执行。如果你用的是 TaoToken 这类聚合入口模型 ID 就填你实际要调用的那个比如claude-sonnet-4-20250514这种格式具体以你客户端模型列表为准。三件套对照表配置项值作用Base URL127.0.0.1:9876Blender 插件与服务端通信地址Key本地握手无需外部 Key服务端与插件配对Model ID客户端所选模型 ID决定 AI 推理能力配完这三样Blender 侧点Connect to Claude客户端侧确认 MCP 服务已加载就可以进入验证环节了。4. 验证请求一次完整的自然语言建模任务复现配置对不对跑一次任务就知道。我建议第一次验证别搞太复杂用一个「地牢 金罐 龙」的经典场景既能覆盖对象创建、材质、灯光又不会因为步骤太多导致超时。先在 Blender 里新建一个空场景删掉默认立方体。然后在 AI 客户端对话框里发第一条指令创建一个低多边形地牢场景地面是石砖四周有石墙中间放一个金罐旁边站一条龙守护它。发送后观察两个地方Blender 视口里是否开始出现对象客户端是否返回执行日志。正常情况下AI 会先调用get_scene_info读取当前场景然后分步执行创建地面、墙体、金罐、龙的 Python 代码。如果第一次命令失败别慌再发一次「继续」或「重试上一步」BlenderMCP 有重试机制通常第二次会成功。接着验证材质修改发把龙的材质改成暗红色鳞片质感金罐改成金属金色。这一步会触发材质节点操作。AI 会创建 Principled BSDF 节点调整 Base Color、Metallic、Roughness 参数。你可以在 Blender 的 Shading 工作区看到节点树变化。再验证灯光和相机把灯光设置成工作室风格相机对准场景设置为等轴测视图。最后验证资源集成和导出从 Poly Haven 加载一些岩石和植被放在地牢角落然后导出为 Unity 兼容格式。如果 Poly Haven 加载失败先检查网络和 API 状态或者临时禁用该选项不影响主体流程。导出成功后你会在 Blender 输出目录看到.fbx或.glb文件。整个流程跑通说明你的 BlenderMCP 配置完全可用。我实测下来这个场景从零到导出熟练操作大概 20 到 30 分钟比纯手工快很多尤其是迭代阶段改材质、换灯光就是一句话的事。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错这一节我把实际遇到的报错和排查路径列出来你对照着看。401 Unauthorized这个通常不是 BlenderMCP 本身的问题而是你 AI 客户端的模型调用鉴权失败。检查你的 API Key 是否有效、是否过期、额度是否够。如果你用的是聚合入口确认 Base URL 填的是https://taotoken.net/api不要多加路径。Key 要填在客户端侧不是 Blender 插件侧。local proxy failed这个报错一般出现在客户端启动 MCP 服务时本地代理进程没起来。排查顺序先确认uvx在命令行能直接运行再确认blender-mcp包已安装。如果客户端日志里显示spawn uvx ENOENT说明系统 Path 没配好回到第 2 节把 uv 的 bin 目录加进 Path。reading choices 报错这个多出现在 AI 返回结果解析阶段通常是模型输出格式不符合 MCP 预期。解决办法是换一个更稳定的模型或者在指令里明确要求「只返回可执行的 Python 代码不要额外解释」。如果持续出现检查客户端版本是否过旧。OAuth 相关报错如果你用的客户端走 OAuth 登录报错可能是 token 刷新失败。退出账号重新登录或者清除客户端缓存目录后重启。注意 OAuth 是客户端和模型服务之间的事和 Blender 插件无关。连接超时Blender 插件点连接后一直转圈。检查 9876 端口是否被占用用lsof -i :9876macOS/Linux或netstat -ano | findstr 9876Windows看。如果被占用改端口两边同步改。首次命令失败后续正常这是已知现象服务端和插件刚握手时可能丢第一条消息重试即可不用改配置。排查时记住一个原则先看客户端日志再看 Blender 控制台。Blender 的Window Toggle System ConsoleWindows或启动时的终端macOS/Linux会打印插件侧的错误比客户端日志更直接。6. 从验证到长期使用把 BlenderMCP 接进你的日常 3D 工作流跑通一次验证只是开始真正省时间的是把它变成日常习惯。我自己的做法是任何新场景先用自然语言让 AI 搭出粗模和布局确认构图和比例没问题再手动精修细节。这样把「创意验证」和「技术实现」分开效率提升最明显。如果你要长期做编码类、Agent 类的任务比如让 AI 连续处理多个场景文件、批量导出建议用 Coding Plan 这类长期方案比按次调用更划算。日常调试模型、验证指令效果用模型对话就够了。接入文档和 API Key 管理在控制台里路径是 API Keys 和接入文档配置时 Base URL 统一用https://taotoken.net/api。最后给几个实用技巧一是复杂操作一定拆成多步一次只让 AI 干一件事成功率最高二是执行前先保存 Blender 文件代码执行功能虽然有限制但养成保存习惯没坏处三是把常用的指令序列存成文本模板下次直接改参数复用四是定期更新插件和 MCP 包项目迭代挺快新版本会修不少连接问题。BlenderMCP 这类工具的价值不在于替代 Blender而在于把「想」和「做」之间的延迟压到最低。你负责描述和判断重复操作交给 AI这才是 AI 辅助 3D 建模真正落地的方式。