这段时间一直在折腾智慧仓储的数字孪生场景说实话刚开始真没想到会用到 Antigravity 和 Blender MCP 这个组合。本来打算纯手搓 Blender 建模结果货架还没摆完就先放弃了——几百个库位、几十台 AGV、还有复杂的动线手动建模根本扛不住。后来换成 AI Agent 驱动 Blender 的方式用自然语言描述需求让 Antigravity 这类智能体平台去调度 Blender MCP 插件执行建模动作整个效率提升了不止一个量级。这篇内容记录的就是我实际跑通的完整链路MCP 协议怎么把 AI 和 Blender 连起来、Antigravity 在中间扮演什么角色、如何用自然语言一步步搭出一个 3D 智慧仓储场景以及落地过程中踩过的坑。适合正在做数字孪生、3D 场景自动化生成或者想用 MCP 打通 AI 与建模工具的朋友参考。我尽量把能直接复用的命令、参数和经验都写出来少说空话。1. 项目整体设计与思路拆解1.1 传统做法卡在哪做数字孪生场景最常规的路径是建模师手工制作或者半自动参数化生成。一份仓储园区级别的场景包含货架、通道、叉车、AGV、提升机、分拣线加上灯光和材质一个人没有两三周很难出效果。更麻烦的是后续改版客户说货架高度变了、通道宽度要调整你就得整批重来。参数化脚本能缓解一部分但脚本每次改动都要重新写逻辑维护成本很高。我原来也试过用纯脚本批量生成写 Python 给 Blender 跑确实能省事但问题在于“沟通成本”。我需要把需求翻译成代码逻辑一行一行写清楚中间只要需求含糊一点脚本就产出莫名其妙的结果。这个体验让我一直觉得3D 场景生成缺少一个“需求入口”直到接触了 MCP 协议和带 AI Agent 的平台才觉得这条路能走通。1.2 Antigravity 负责“想”Blender MCP 负责“做”这套链路的核心分工很简单Antigravity 这类 AI Agent 平台负责理解人类的需求、拆解任务、决定调用哪些工具、按什么顺序调用而 Blender MCP 插件作为被调度的执行端负责把指令翻译成 Blender 里的具体操作。打个比方Antigravity 像是一个项目负责人你告诉他“建一个 2000 平米的仓库摆 5 排货架每排 20 列”他听完后自己列计划先建地面再立柱子然后生成货架再把材质贴上。Blender MCP 就是他的双手每一句计划都会变成实际的建模动作。这条链路里最关键的是 MCP它相当于给 AI 装了一个“通用插座”。不管下游工具是 Blender、浏览器还是数据库只要实现 MCP ServerAI Agent 就能通过标准协议调用能力不用再针对每个工具单独做适配。我在实际配置中使用的是 Antigravity 平台中自定义 MCP Server 的能力把本地启用的 Blender MCP 服务地址填进去平台就能发现插件暴露出来的工具方法例如创建物体、设置材质、导出场景等。1.3 仓储数字孪生需要怎样的场景底座聊工具之前先说说目标场景本身。智慧仓储数字孪生最简单的阶段是先把仓库的几何结构、设备布局、关键动线用 3D 方式还原出来高级一点还要把库存数据、设备状态实时同步到模型上让虚拟世界和真实世界联动。我这次的目标是搭出“能看、能改、能导出”的场景底座能看是指货架、AGV、通道一眼过去符合真实比例能改是指需求变更时能快速调整布局能导出是指模型可以转成 glTF/GLB丢给前端 Three.js 或者 Unity 做二次开发。基于这个目标我在设计整个搭建流程时把“指令自然语言化”放在第一位。手工做的网格体再精细如果没办法用 AI 按参数批量生成后面迭代起来还是累。所以整套流程的落点不是某一个模型而是让 AI 能按描述实时产出、实时调整场景这才是比传统方式值钱的地方。2. 核心概念与工具链拆解2.1 MCP 协议AI 工具调用的“通用插座”MCP 全称是 Model Context Protocol模型上下文协议。它最早由 Anthropic 提出目的很直白让大模型应用能以标准方式连接外部工具和数据源。你可以把它理解成 AI 世界的 USB-C 接口——接口统一了各种设备插上去就能通信。在实际链路上MCP 是标准的客户端-服务器架构。AI Agent 是客户端工具插件是服务器。客户端通过 JSON-RPC 格式的消息与服务端通信服务端把自己能力声明为一组“工具”每个工具都有名字、描述和参数结构。Agent 需要执行某个操作时就调用对应工具就像调用一个远程函数。服务端返回结果Agent 再决定下一步做什么。这种设计带来的最大好处是模型不需要预先把某个软件的操作逻辑“训练”进脑子里只要 MCP Server 把工具暴露出来模型在运行时就能发现并使用。对 Blender 来说只要装上一个实现 MCP Server 的插件AI 就能获得在 Blender 里创建物体、操作材质、导出场景的完整能力。很多人搜“mcp是什么”“mcp是软件协议还是硬件协议”这里可以明确说法MCP 是软件层协议和硬件无关它只负责应用与应用之间的调用关系。类比起来它更像传统开发里的 RPC 框架只不过服务发现的目录是给大模型看的动作描述要足够自然语言化。注意到现在不只是 Blender浏览器自动化、API 测试、数据库操作这些领域的 MCP 插件也开始多起来每个工具都在抢着接入这个生态。2.2 Blender MCP 插件能给 AI 暴露什么能力Blender MCP 插件是社区里兴起的一个开源项目也有人叫它 BlenderGPT 风格的工具理念是用 MCP 协议把 Blender 变成 AI 可操作的终端。它能暴露的能力按我的使用经验主要分这么几类创建物体立方体、圆柱、球体、平面、文本等基础几何体甚至可以直接创建带尺寸参数的物体。场景变换移动、旋转、缩放支持以某个物体为参照做相对定位。材质与颜色预设材质、修改颜色、金属度、粗糙度。父级与层级把物体挂到某个父节点下建立结构树。关键帧与动画设置关键帧让物体按轨道运动。文件导入导出导入外部模型或者把当前场景导出为 glTF/GLB。详细的工具清单会以 JSON Schema 形式发给 AI AgentAgent 会根据任务自动选择合适的工具和参数。比如你说“生成一个 1.2 米高的货架立柱”Agent 很可能就会调用创建圆柱体的工具并传入 height1.2、radius0.05 这类参数。安装上大致是这么几步在 Blender 偏好设置里开启插件指定一个端口插件会在本地启动一个 WebSocket 服务等待 MCP 客户端连接。于是任何支持 WebSocket 的 MCP 客户端都能连上。2.3 Antigravity 在链路里的角色Antigravity 是我实际使用的 AI Agent 平台它的核心能力是把大模型和工具组合成一个能自主执行任务的智能体。在项目里它承担三层职责理解自然语言需求、编排多步操作、根据执行结果做调整。理解需求这一步其实就是普通聊天能力但关键是它能把宽泛的需求拆成具体的建模指令。比如“在仓库东侧放一台 AGV”Agent 需要自己判断仓库东侧的坐标范围、AGV 底面尺寸和高度然后按批次调用创建物体的工具。编排多步操作体现在它会按顺序执行几十个工具调用而不是每次都让你重复确认。执行结果如果失败它会读取返回信息决定重试还是改参数。把 Antigravity 和本地跑着 Blender MCP 的电脑连起来常规的做法是平台提供自定义 MCP Server 配置入口填写本地服务的地址和协议。这样一来平台就能发现并调用 Blender 的所有工具方法。我使用的时候因为要跑仓库场景所以经常一句话就是一整套指令“给整个仓库换成一号库位标准货架高度改为 3 米通道宽度保持 2.4 米不变。”Agent 会先处理尺寸和坐标再逐个工具执行实测下来基本不用我再手动去调整。3. 实操过程从零搭出一个 3D 智慧仓储场景3.1 环境准备与插件安装先交代环境我使用的是 Blender 4.1 LTS系统是 Win11Python 版本最好让 Blender 自己控制的那个“系统 Python”否则 pip 装包容易出问题。不过新版 Blender MCP 插件不需要额外装 Python 包直接作为插件导入即可。具体安装是这样的打开 Blender进入“编辑 - 偏好设置 - 插件”点“安装”选择你下载好的 MCP 插件 zip 包然后勾选启用。控制台会看到监听地址和端口默认是 9876。然后到偏好设置的“MCP Server”面板确认状态是 Running。然后打开 Antigravity 平台在 Agent 配置里添加自定义 MCP Server填入本地地址 ws://127.0.0.1:9876。如果你是公网环境就要填对应的局域网或云端地址还要注意防火墙放行端口。配置好后平台会自动拉取工具清单这时候你在对话框里发指令Agent 才能调用 Blender。有一个细节是本地服务地址如果写成 localhost 在某些平台会识别成平台云服务器本身所以保险起见填 127.0.0.1 或者局域网实际 IP尤其是 Agent 运行在云端的场景。3.2 第一步用自然语言生成仓储“毛坯房”毛坯房就是地面、墙体、柱网、屋顶这些基础空间结构。我下发的第一条指令大概是这样的“创建一个长 60 米、宽 40 米、高 8 米的仓库空间。先建地面厚度 0.3 米沿四周建墙高 8 米厚 0.2 米在内部按 10 米间距布置柱网柱子为圆管直径 0.4 米。”Agent 会先拆分任务把“地面”理解为尺寸为 60x40x0.3 的立方体把“柱子”理解为多根圆柱按坐标网格排列。这里有个要点Blender 默认单位是米所以只要描述里说清楚米制尺寸AI 会用数值对应到 Blender 的单位不会出现一栋楼 60000 个单位这种尴尬。完成后在视口里应该能直接看到地面、墙体和柱子。检查柱网间距是否均匀60 米长方向、10 米间距应该是 5 根40 米宽方向、10 米间距是 3 根合计 15 根柱子。如果发现数量不对直接跟 Agent 说“柱子数量不对按等间距重新分布”它会重新计算坐标再生成。3.3 第二步批量生成货架、托盘与货物毛坯房有了接着放货架。我的指令是“沿宽度方向布置 6 排货架每排长度 25 米货架高度为 3 米。每个货架有 5 层每层放 20 个托盘托盘上放标准箱。所有货架命名格式为 Rack_排号_列号。”这一步最能体现 MCP 批量生成的价值。手工放 6x20 个托盘再手动堆箱至少要一上午Agent 通过循环调用创建工具几分钟就能完成全部。关键点在于命名规范我发现 Agent 用自然语言描述能理解“命名格式”这种要求这样后期在 Blender 里按名字筛选物体或者在导出后给前端做数据关联都很方便。托盘和货物建议单独放一个集合Collection货架放另一个集合。如果你没指定层级它们会全部堆在根节点后面整理会想哭。所以我会提前告诉 Agent“托盘和货物放在 Collection_Trays 集合下货架放在 Collection_Racks 集合下。”3.4 第三步AGV 小车与动线设计仓库里最核心的设备就是 AGV。我先创建一台标准 AGV 模型然后用水平贴地的方式摆放到指定位置。指令写成“在仓库南侧入口处生成一台 AGV 小车长 1.0 米、宽 0.8 米、高 0.6 米颜色为橙色命名 AGV_01。”接下来是动线。数字孪生的“动态感”主要靠路径和动画体现。我让 Agent 给 AGV 添加一条循环路径从南侧入口出发经过货架通道到达东侧分拣区再绕回到南侧。Agent 会先计算途经点再在 Blender 里创建一条路径曲线最后让 AGV 沿着曲线运动并设置关键帧。这里我想强调一句AI 做动画非常依赖你对坐标和方向的定义。比如“南侧”到底在哪个方向模型里默认 Y 轴朝前还是 X 轴朝前如果这些基准没约定Agent 生成的运动轨迹很可能跟你心里想的不一致。建议在初始提示里就约好坐标约定例如“X 轴向东Y 轴向北地面在 Z0 平面”。3.5 第四步导出 glTF 对接前端场景建好只是第一步数字孪生通常要对接前端展示我导出的是 glTF/GLB 格式。指令“把所有货架、托盘、AGV 和地面导出为一个 GLB 文件包含位置旋转缩放信息输出到 D:\DigitalTwin\warehouse_v1.glb。”Blender MCP 插件如果暴露了导出工具Agent 会直接执行导出如果没有也会告诉你手动导出路径。导出后的 GLB 可以丢给 Three.js 加载或者导进 Unity 继续做交互。对前端数字孪生网站来说GLB 是最省心的格式纹理和模型都在一个文件里。导出前建议检查两件事所有物体必须有明确名称因为前端通常按名称绑定数据所有物体最好应用一下缩放我的做法是在 Blender 里 CtrlA 应用全部变换否则在 Three.js 里会出现 0.01 这种缩放的奇怪模型。前端加载 GLB 的核心代码很简单三五行就能跑起来import { GLTFLoader } from three/examples/jsm/loaders/GLTFLoader.js; const loader new GLTFLoader(); loader.load(warehouse_v1.glb, (gltf) { scene.add(gltf.scene); });如果你也在做前端数字孪生这块基本是标配重点其实是模型命名和数据绑定。4. 常见问题与排查技巧实录4.1 Antigravity 侧的报错与解决我留意到热词里有一批和 Antigravity 报错相关的“antigravity agent execution terminated due to error.”、“antigravity 403”、“antigravity eligibility check failed”、“antigravity 更新出错”。我挑几个说下我的排查结论。先说“agent execution terminated due to error”。这个通常不是平台挂了而是 Agent 在执行过程中某个工具调用返回异常导致整个任务链中断。解决办法是先在会话里把错误日志打开看具体哪个 MCP 工具返回了异常如果是 Blender MCP 没响应大概率是 WebSocket 断了重启插件再试。“eligibility check failed”更偏账号权限问题多数是账号状态或功能灰度未开放。最直接的方法是确认账号是否已通过资质校验、功能配额是否用完以及当前所在环境是否支持目标能力。403 一般出现在访问受限接口检查 MCP 地址是否写错、认证 token 有没有过期。4.2 Blender MCP 连接类问题Blender MCP 连接不上是新手最容易遇到的坑。常见表现是 Agent 创建好了所有任务但 Blender 端没有任何反应。我的排查顺序是先看 Blender 控制台如果显示 MCP Server Running说明端口在监听如果显示 Connection error多半是端口被占用或 WebSocket 服务没起来。接着看防火墙Win11 经常默认拦截外部连接需要把 Blender 加入允许列表。最后看地址如果 Agent 运行在云端就不能填 127.0.0.1要填你电脑的局域网 IP 或做端口映射。有个细节很容易忽略部分老版本插件需要手动指定“允许外部连接”否则只监听本地回环。你在界面上没看到这个开关就要去插件源码里找 server 的 bind IP 参数改成 0.0.0.0。另外插件端口被占用时换一个端口重新启动再在 Antigravity 的 MCP 配置里同步改地址。4.3 建模质量与比例问题AI 建模常见的质量问题有三个比例不对、面数爆炸、物体重叠。比例不对是最容易出现的。比如你让 AI 创建一台“高 1 米”的 AGV但如果 Blender 场景单位搞成了厘米AI 传的数值就会被当成 1 厘米。遇到这种情况先在场景属性里把单位设为米同时检查长度缩放是否为 1.0。面数爆炸一般出现在圆柱、球体这类几何体上。默认细分值很高几百个货架每根柱子都是 64 段圆柱整个场景瞬间几十万面后面渲染和前端加载都吃不消。我的做法是在指令里明确“柱子的段数设置为 12”或者统一在插件配置里降低默认生成几何体的环段和扇段数。物体重叠的问题本质是坐标计算不精确。多根柱子摆在同一坐标点或者托盘嵌进货架里。遇到这种情况我偷懒的办法是把整个布局打散成单个物体的变换信息导出放到前端再通过逻辑修正更靠谱的办法是让 AI 用“底面坐标”而不是“物体中心坐标”去定位尤其像柱子这种中心在中间的物体很容易出现半截埋进地面的情况。5. 经验总结与后续扩展5.1 我的几个实操心得这套链路上手难度不高但想用得顺手有几个心得值得分享。第一个是任务拆分。不要一句“给我建一个智慧仓储”就甩给 Agent它是吃提示词的任务越明确生成越稳定。我一般会把整个仓库拆成“毛坯结构”、“仓储设备”、“AGV 系统”、“导出对接”四个阶段每阶段单独下发指令。第二个是命名规范。Agent 生成的物体默认名字很乱比如 Cube、Cube.001你必须从第一根柱子开始就要求它按“柱网_行号_列号”这种方式命名。这个习惯一旦养成后面筛选、匹配数据、排序都会非常爽。前端做数字孪生时很多场景数据绑定都是靠物体名称对应数据库字段名字规范意味着少写一堆映射代码。第三个是建立模板。如果你们公司要做多个仓储项目建议把“仓库尺寸 货架规格 AGV 型号”这类参数做成标准模板每次新建项目直接套模板让 Agent 按模板参数生成。我在这个项目里试过生成一个不同尺寸的新场景从指令到完整模型只要半小时。5.2 这个组合还能往哪走完成场景底座之后下一步自然是数据驱动。比如把库存系统的数据接到模型上每个托盘的位置、数量、品类实时映射到模型里货架上的箱子颜色随库存状态变化这就是真正的数字孪生联动。还有个延伸方向是 3D 点云。热词里有人搜“3d 点云拉框”“3d 结构光相机”说明不少人想把激光雷达扫描的真实仓库点云和这些生成的模型统一到一个场景里。我和团队做过一轮验证很简单先把点云导入 Blender再用 MCP 工具创建对照框体让 AI 根据点云坐标自动对齐货架模型。原理是让 AI 生成低模“框”再把高模贴合上去。完成之后数字孪生的“真实度”会大幅提升。如果是想接 Unity 项目GLB 可以直接导入 Unity 做场景搭建不过要注意 Blender 里默认的坐标轴和 Unity 有差异导入时物体朝向可能需要旋转通常是把 X 轴旋转 -90 度或者直接在 Blender 里先调整物体朝向再导出。最后想多说一句实操体会这套组合最让我惊喜的其实不是“AI 能建模”而是“AI 能按你的方式工作”——只要你把命名、层级、坐标约定说清楚它生成的东西就能直接进生产流程而不是停留在 demo 阶段。这比单纯追求“一句话生成整个场景”更有价值。我后来越来越倾向于把它当团队成员用而不是偶尔调戏一下的玩具。如果你手里也有类似的 3D 场景项目建议从一个小场景试起把命名和坐标约定写进提示词里跑通一遍之后你会发现原来一周的建模量真的可以压缩到半天。