用Antigravity与Blender MCP构建智慧仓储数字孪生场景

把 Blender 变成 AI 能直接指挥的三维建模环境再让 Antigravity 这类云端 AI 开发平台通过 MCP 协议把整个智慧仓储场景一步一步搭起来——这套组合我实际跑了大概三周做出的数字孪生初版已经能从空场景一路生成到货架、库位、AGV 路线。这篇文章是这个系列的上半篇重点讲思路、环境搭建和静态场景建模下篇再展开动态调度和数据回传。适合正在做 3D 智慧仓储、数字孪生园区、前端三维可视化又不想在 Blender 里手动逐物体建模的同学参考。1. 项目整体设计与思路拆解1.1 为什么选 Antigravity Blender MCP先说 MCPModel Context Protocol。你可以把它理解成给 AI 装了一排标准化的插座以前每个软件都要给 AI 定制一套对接方式现在只要实现了 MCP 协议AI 就能通过统一的工具调用接口去读写外部软件。Blender MCP 就是其中一个具体实现它在 Blender 里跑一个插件监听本地端口接收来自 AI 的 Python 脚本并执行。Antigravity 是 Google 的云端 AI 开发环境和 Gemini 深度集成本身支持 MCP 服务配置可以直接把“建立一个仓库地面”“生成 10 排货架”这类自然语言意图翻译成 Blender 操作。我选这套组合最核心的原因是“AI 负责建模逻辑Blender 负责空间表达MCP 负责桥接”。之前试过直接在 Blender 内置脚本里写死参数每次改库位数都要去翻代码也试过让 AI 生成 Python 脚本再手动复制到 Blender效率很低。现在通过 Antigravity 的对话框我可以直接说“把货架间距从 1.2 米改成 1.5 米顺带把每层库位从 2 个改成 3 个”Antigravity 会通过 MCP 工具调用 Blender MCP 服务更新对应对象。这种体验才是数字孪生建模工具该有的样子。也许有人觉得这只是把“写脚本”变成了“说需求”本质上还是生成代码。但实操过几次就会发现MCP 真正解决的是闭环问题AI 生成指令后能立刻拿回 Blender 的执行结果还能继续读取场景里的对象清单。这个“读写循环”让 Antigravity 不再是一锤子买卖的代码生成器而是可以持续修改三维场景的远程协作者。1.2 一条主线从模型资产到场景逻辑数字孪生不等于三维模型它至少包含三层空间结构、设备状态、业务数据。这个初版项目里我用 Blender 承载空间结构仓库地面、墙、柱、货架、库位、AGV 道路、装卸口在货架和库位上记录状态属性库位编号、容量、占用状态、温度区间如果是冷链仓AGV 路线用曲线表示为下篇的动态调度留出挂载点。整体变成一个可查询的场景图。举例一个货架对象在 Blender 里的名字可能是 Shelf_03_Row_04它的自定义属性里写着 {zone: A3, capacity: 60, occupied: 23}。这些属性最终会导出到 JSON前端三维可视化或后端库存系统都能直接读取。换句话说Blender 在这里不只是渲染器还是可信的场景数据库AI 能通过 MCP 随时查看和修改。我建议你在做自己的数字孪生时一开始就分清“模型层”和“数据层”模型层是能看见的网格、材质、曲线数据层是挂在对象上的属性、命名规则、层级关系。很多项目做到一半就乱本质是两层混在一起库位信息直接写在对象名里一旦改名就丢数据。Blender 自定义属性和空对象这套机制本身就适合做轻量级数据承载务必利用起来。1.3 方案选型的几点权衡有人问Unity 也能做数字孪生为什么还要绕一圈 Blender因为 Unity 强在运行时逻辑和交互但当你需要离线批量建模、生成大量重复货架、按坐标精确摆放物件时Blender 的 Python API 和节点式操作更方便。我通常的做法是Blender 负责资产生产Unity/Three.js 负责前端表现。真要做实时交互项目再把 Blender 导出的模型放进 Unity效果并不差。还有人问我直接手写 Python 脚本不也一样一样但效率不在一个量级。Antigravity 这类 AI 开发环境的价值是“对话式修改”它会根据当前场景自动补充上下文不需要你精确点名对象路径同时它还能反过来读取 Blender 场景告诉你“现在库位总共有多少个缺口在哪里”。MCP 在这里就是把 AI 和场景连接起来的总线。从成本角度看这套方案也比传统建模外包便宜很多不需要重新学习复杂的 DCC 工具不用手动拉几百个重复货架只要定义好规则AI 加上 Blender 就能批量产出。对创业团队或小规模数字孪生项目尤其友好。2. 核心细节解析与实操要点2.1 Antigravity 侧 MCP 配置细节Antigravity 的 MCP 配置按项目级维护通常在项目根目录放一个 .mcp.json 文件。我建议把配置写在 IDE 工作区里而不是全局配置这样同一个项目换队友时可以直接同步。下面是一个最小配置{ mcpServers: { blender-mcp: { command: python, args: [-m, blender_mcp], env: { BLENDER_MCP_HOST: 127.0.0.1, BLENDER_MCP_PORT: 9876, BLENDER_MCP_TOKEN: your-local-token } } } }配置里最关键的是 command 和 args。如果你在本机已经装好 blender_mcp 服务包可以用 python -m blender_mcp 直接启动如果是用 uvx 工具则改成 uvx blender-mcp。端口和 Token 也要和 Blender 插件面板里的值保持一致。很多“Antigravity 更新出错”的问题其实是启动 MCP 服务的 Python 环境版本变了或者服务包没重新安装导致 IDE 连不上。还需要注意Antigravity 自身也会有一些登录态校验长时间不用后登录状态容易过期表现为工具调用前突然报 403。这种时候先重新登录 Antigravity再重启 MCP 服务节点别一上来就怀疑配置文件。如果你同时接入了 Playwright MCP、Chrome DevTools MCP 这类浏览器自动化服务配置结构完全相同只是 command 和 args 不一样排障思路也能复用。2.2 Blender MCP 插件的安装与启动顺序Blender 侧要装插件。路径是“编辑 - 偏好设置 - 插件 - 从磁盘安装”选中 blender_mcp 插件压缩包或目录启用后在 3D 视图右侧 N 面板找 MCP 面板填入监听地址和端口点击连接。部分版本还会要求你设置 Token这个 Token 必须和 Antigravity 配置里的 BLENDER_MCP_TOKEN 保持一致否则插件会拒绝执行脚本。插件启动后Antigravity 侧连接才有意义。整个顺序我建议固定为先开 Blender先加载插件并连上端口再打开 Antigravity 工作区等它把 MCP 工具加载出来最后在对话里发指令。如果你先把 Antigravity 启动并加载了工具再开 Blender工具列表可能会变成“死连接”需要刷新项目或重开 IDE。另外不要开着两个 Blender 实例同时监听同一个端口。我在测试时遇到过一个老场景实例占用了 9876 端口新实例连接失败Antigravity 却以为连上了执行脚本时要么超时要么报“agent execution terminated due to error”。排查方法很简单把所有 Blender 实例关掉只留一个重连。插件面板上的状态灯并不总是可靠最直接的办法是把服务日志打开。2.3 MCP 工具调用链路说明一次典型的 MCP 调用链路是这样的你在 Antigravity 对话框输入“在坐标 (10, 8, 0) 放一个 2x1x1.2 米的货架” - Antigravity 把它理解为一个工具调用的参数 - MCP server 收到参数后转成 Blender Python 代码 - 通过 TCP Socket 发给 Blender 插件 - 插件在当前场景执行 bpy 代码 - 把执行结果返回给 Antigravity。关键点返回给 Antigravity 的通常是文本例如“成功创建对象 Shelf_001”。不会自动弹出一个 Blender 窗口也不会在 IDE 里显示三维预览。所以我在实践里会把 Blender 窗口放在副屏随时看结果部分 Blender MCP 插件支持截图回传如果版本里有截图工具建议打开这能让 AI 根据截图修正后续操作。这里可以类比一下这套链路和 Playwright MCP、Chrome DevTools MCP 是一模一样的思路。前者让 AI 操作浏览器 DOM后者让 AI 操作 Blender 对象。如果你之前用过浏览器自动化 MCP再上手 Blender 基本没有认知成本。唯一要多适应的是 Blender 的 Python API 比较复杂AI 生成的代码偶尔会调用过时函数需要你在 Blender 控制台里观察报错。3. 实操过程与核心环节实现3.1 第一步用 MCP 在 Blender 中创建仓库地面与墙体我先让 Antigravity 执行“在 Blender 里新建一个 40 米长、25 米宽的仓库地面厚度 0.1 米颜色浅灰在北侧和西侧分别加一道高 5 米、厚 0.3 米的墙颜色偏白。” Antigravity 生成的脚本接近这样import bpy # 地面 bpy.ops.mesh.primitive_cube_add(location(0, 0, 0)) floor bpy.context.object floor.name Floor floor.dimensions (40, 25, 0.1) floor.location (0, 25 / 2, 0) # 北墙 bpy.ops.mesh.primitive_cube_add(location(0, 0, 0)) north bpy.context.object north.name Wall_North north.dimensions (40, 0.3, 5) north.location (0, 25, 5 / 2)这里要注意我默认把地面左下角放在世界原点而不是把中心放在原点。为什么因为后续所有货架、AGV 点位的坐标都来自真实仓储的平面坐标左下角对齐后Blender 内的坐标可以直接映射到真实米制坐标省掉一次原点偏移。如果你习惯中心对齐后面导出 JSON 时每个对象都要额外做减法容易出错。为了让场景更像数字孪生底图我还会让 AI 创建地面材质新建一个材质槽基础色设为浅灰 (0.8, 0.82, 0.85)roughness 设为 0.9墙壁用白色。别看这些渲染参数对业务逻辑不重要但有了一致的材质后后续在前端 3D 网页渲染中容易统一风格避免了“一个物体亮到刺眼、另一个物体黑成一片”的尴尬。同时把地面的碰撞体或显示选项关掉可以减少 Blender 视口卡顿。3.2 第二步参数化生成货架与货物堆货架是仓储模型里重复度最高的对象千万不要生成单个再复制而要写循环。我的目标场景是中间库区 10 排货架每排 20 组总共 200 组每组货架长 2 米、宽 1 米、高 4 层层间距 1.2 米。对话指令写清楚这些参数Antigravity 会生成类似脚本import bpy def create_shelf(row, col, x, y): # 创建一个简易货架主体 bpy.ops.mesh.primitive_cube_add(location(x, y, 2.0)) obj bpy.context.object obj.name fShelf_{row:02d}_{col:02d} obj.dimensions (2.0, 1.0, 4.0) return obj for row in range(10): for col in range(20): x row * 3 1 y col * 2.5 1 create_shelf(row, col, x, y)当然光是 Blocking 式货架不够还要给每个货架挂业务属性。我的建议是为每个货架对象添加自定义属性 code、capacity、occupied然后再建一个空对象 Storage_Meta专门存整体库存统计 JSON。自定义属性就像给 3D 物体贴了一张数据标签导出时统一读取特别适合“拉框”和点云标注场景。比如你在 3D 点云里框出一个库位范围最后得到的就是一组坐标和属性Blender 里完全可以用同样的方式管理。一个小经验建议一个对象对应一个库位而不是一个货架对应一个库位。如果库位需要单独被库存系统引用就拆成“库位 Parent 为空对象子物体是 Box 和文字标签”这样前端能精确高亮某个库位。货架层级分清楚之后后续改容量或状态都有明确的对象路径Antigravity 在调用时也比较容易定位不会在两百个对象里迷失。3.3 第三步AGV 路径与设备点位建模AGV 路线不要做成一段段小方块而应该用曲线。我给 Antigravity 的描述是“创建一条橘黄色粗曲线从西侧装货口开始经过库区中央通道再到东侧出库口沿途绕过三组货架。” Antigravity 会用贝塞尔曲线生成import bpy curve_data bpy.data.curves.new(nameAGV_Path, typeCURVE) curve_data.dimensions 3D spline curve_data.splines.new(typeBEZIER) # 设置4个控制点坐标 pts [(0, 2, 0), (10, 12, 0), (20, 20, 0), (38, 22, 0)] spline.bezier_points.add(3) for i, (x, y, z) in enumerate(pts): p spline.bezier_points[i] p.co (x, y, z) p.handle_left_type AUTO p.handle_right_type AUTO obj bpy.data.objects.new(AGV_Path, curve_data) bpy.context.collection.objects.link(obj)曲线生成后设置 bevel_depth线条在视图中就变得可见。这里关键是不要直接使用默认的多段线因为 AGV 后面要做小车运动的路径约束贝塞尔曲线能被 Blender 的 Follow Path 约束读取。如果你只是想在场景里显示一条线用曲线就够了如果下篇要加动画曲线控制点就是现成的导航点。设备点位我用空对象 Empty 处理。理由Empty 对象不占网格资源只有 Transform 信息适合作为设备挂点。比如创建 Empty 名为 AGV_01_Home填上设备编号、类型、充电位置等属性再让具体的 AGV 小车模型作为它的子对象。以后需要调整 AGV 位置只需移动挂点小车模型自动跟随业务逻辑里不用关心模型的网格结构。这个模式同样适用于机械臂、打包台、充电桩等设备。3.4 第四步把 Blender 场景导出为前端可用的模型与 JSON很多人在搜“Blender 如何导出 JSON”注意 Blender 默认没有直接导出 JSON 的功能需要写导出脚本或者让 AI 通过 MCP 去执行。我通常同时导出三样东西glTF 模型文件.gltf/.glb用于 Three.js 等 Web 渲染FBX 文件用于 Unity 或 DCC 工具转换一个场景结构 JSON记录对象名、坐标、旋转、缩放和自定义属性。场景结构 JSON 的导出脚本类似import bpy, json scene_data {objects: []} for obj in bpy.context.scene.objects: if obj.type in {MESH, CURVE, EMPTY}: scene_data[objects].append({ name: obj.name, type: obj.type, location: list(obj.location), rotation: list(obj.rotation_euler), scale: list(obj.scale), parent: obj.parent.name if obj.parent else None, properties: {k: v for k, v in obj.items() if k ! _RNA_UI} }) with open(//warehouse_scene.json, w, encodingutf-8) as f: json.dump(scene_data, f, ensure_asciiFalse, indent2)这里有个关键细节属性里的值如果是自定义类型比如向量或嵌套字典JSON 里会被序列化成字符串或数组建议在导出前统一转成原生类型。否则前端解析时还要再做一次类型清洗。导出文件路径用“//”开头是 Blender 相对路径它会自动放到当前 blend 文件所在目录不怕找不到。如果你只导一次也可以让 AI 输出绝对路径但多人协作时相对路径更稳。如果目标是 Web 端展示glTF 导出要注意坐标轴。Blender 使用 Z-upThree.js 常见 Y-upglTF 规范会自动转换但如果你自己写 JSON 并把 Blender 坐标裸给前端前端渲染时很可能出现模型侧躺。我的处理是在前端 Three.js 加载器里设置坐标轴转换或者导出时就把 Y 和 Z 交换写进 JSON。这也是为什么有人会在网上搜“CSS 3D 旋转正负判断”这类问题坐标轴与旋转正负是三维可视化绕不开的细节。4. 常见问题与排查技巧实录4.1 Blender MCP 连接不上怎么办先把现象分类是 Antigravity 的工具列表里看不到 blender-mcp还是能看到但调用超时如果是前者基本是 MCP server 没起来检查命令行是否真的能执行 python -m blender_mcp如果是后者多半是 TCP 环节有问题。我的排查顺序是确认 Blender 插件已启用并处于监听状态面板显示地址和端口在终端执行本地端口测试看 9876 端口是否通检查两个端口配置是否一致以及 Token 是否大写或多了空格关掉多余 Blender 实例重启插件重连。实操经验曾经遇到本机防火墙拦住了 Blender 的监听端口明明插件显示已连接但 AI 调用总超时。后来把 blender_mcp 服务、Blender、Antigravity 三个程序都加入允许名单才恢复正常。这类问题通常跟代码无关而是本地网络策略需要在系统层面放行。4.2 Antigravity 工具调用报 403 或执行终止搜“antigravity 403”情况可能有几种IDE 登录态过期、MCP 服务返回了非授权令牌、或者工作区和项目配置不一致。我的处理是先重新登录 Antigravity然后重启 MCP 服务再试一次最小指令比如“列出当前场景的所有对象名”。如果仍然 403看看 MCP 服务返回日志确认是不是 Token 校验失败。“agent execution terminated due to error”这个报错我也踩过。多发生在一条指令里让 AI 连续创建几十个高精度模型Blender 处理不过来时插件没及时返回Antigravity 执行超时AI 直接杀掉会话。解决办法是把任务拆小先创建地面再创建货架再创建 AGV 路线分步确认另外把模型的细分面数调低仓储初版建模不需要高精度够看就行。高精度可以在确定方案后再统一增加。4.3 模型坐标与真实仓储位置对不上合作项目里最容易出现“货架数字对但 3D 场景一看就乱”的问题。我复盘过几次最终都能归到三个原因单位不一致Blender 默认单位是米但如果你导入过 CAD 平面图可能被缩放成毫米或英尺原点不一致真实坐标系原点和 Blender 世界原点不在对应位置旋转正负Blender 的旋转方向和前端 Y-up/右手系换算不一致。解决办法也很简单统一在 Blender 里做一次坐标校正。比如把所有对象减去某个基准点把原点搬到地面左下角或者写一个循环把所有 Y 轴和 Z 轴交换后导出。校正完成后不要再用“肉眼拖动”去移动物体否则又要重新对应。如果你每次修改后都发现偏移量固定那大概率是缩放倍率问题直接写脚本批量处理即可。4.4 关于 3D 点云和拉框这个项目能用上有人搜到“3d点云拉框”“3d点云”“自驾基础技能培训拉框”说明对点云标注有需求。在仓储数字孪生里点云常来自 3D 结构光相机或激光雷达扫描用于生成真实仓库的点云底图。Blender 可以导入 PLY、XYZ、LAS 格式的点云导入后在 3D 视图中像“颗粒状云层”一样参考拉框就是在点云上框选某个范围生成一个 Box 对象来表示障碍物或库位。Antigravity Blender MCP 做这件事的思路是让 AI 读取点云文件格式计算出目标区域的包围盒AABB再通过 MCP 创建 Box 对象并添加属性。比如“在点云中框出 A3 库区范围 X 从 10 到 18、Y 从 20 到 28高度 0 到 3 米”这就是一次典型的坐标拉框。如果后续要做 3D 点云数据标注这套流程甚至可以直接复制到自动驾驶或物流场景的标注工具里只是 Blender 的性能处理不了超大点云几百万点以内问题不大。5. 下一步可做的扩展从静态到动态5.1 让 AGV 小车沿着曲线跑起来下篇我准备做的是 AGV 动画。既然已经用贝塞尔曲线建了路径就可以创建一个 AGV 小车模型给它添加 Follow Path 约束并设置目标曲线为 AGV_Path然后在 Antigravity 里控制时间轴关键帧让小车按固定速度移动。更进一步可以对接一个模拟库存系统按任务列表驱动小车运动。这里要留意动画帧率、小车是否翻转、曲线方向都要在脚本里确认。Antigravity 生成的运动约束脚本经常忽略“曲线方向反转”的问题所以我在做完路径约束后会特意让 AI 把曲线旋转 180 度再测试一遍。如果小车跑起来是倒退的问题通常出在约束的世界坐标空间设置上调整 follow 选项即可。5.2 业务数据接入与前端 3D 网页渲染数字孪生如果只有静态模型那顶多叫“三维沙盘”。要变成真正的数字孪生需要业务数据回流。我的下篇计划是用 Antigravity 写一个轻量后端服务定时读取库存系统的状态再把状态映射成 Blender 场景的物体属性前端用 Three.js 加载 glTF 和 JSON实现 3D 网页渲染。有人搜“前端数字孪生网站”其实就是这条链路。另外如果要做 Web 自动化验证可以把 Playwright MCP 和 Chrome DevTools MCP 一起接进 Antigravity让 AI 自动打开页面检查模型加载、坐标是否偏移、相机角度对不对。这套 MCP 组合我用下来很顺手一个负责浏览器一个负责 BlenderAntigravity 在里面充当总指挥。项目里的 JSON 属性和 glTF 资产也都需要这种自动巡检方式保证发布前后不出问题。跑完整个上篇我最明显的感觉是Antigravity Blender MCP 最值得用的场景不是“让 AI 天马行空建模”而是把重复、参数化、可描述的空间搭建任务交给 AI自己把精力留给业务规则和数据结构。如果你也正在做智慧仓储、数字孪生园区或者只是想把 Blender 接入 AI 工作流建议先按这篇文章把静态场景跑通。等你尝到“说一句话就生成一排货架”的甜头下篇的动态部分自然会很有兴趣。