最近在做一个智慧仓储可视化项目核心需求是把仓库的实时库存、设备状态、订单流转全部映射到一副可交互的3D场景里。传统方案是前端工程师用Three.js一点点搭场景、绑数据然后写死一堆交互逻辑遇到业务调整就得改代码非常折腾。后来我换了一条路让AI Agent直接操刀Blender建模——用Antigravity做任务编排通过MCP协议把Blender的Python API暴露给智能体。这篇文章把项目落地过程中的方案选型、实操步骤和踩过的坑完整拆一遍如果你也在做数字孪生相关的东西尤其是仓储物流领域的可视化应该能少走不少弯路。1. 项目全景Antigravity 和 Blender MCP 到底解决了什么问题1.1 数字孪生项目最卡壳的环节其实不在建模很多人一听到数字孪生就以为难点在3D建模实际上真做起来你会发现建模只是体力活。仓库里几百个货架、几千个货位、几十台AGV这些模型本身花点时间都能建出来。真正让人头疼的是模型怎么跟着业务数据动起来。传统做法是这样的业务系统里库存数据发生变更 → 后端推送消息 → 前端写一段JavaScript去改Three.js里某个对象的颜色、位置或显隐。听起来不复杂但一旦数据量上来、状态维度变多比如库容、温度、湿度、AGV电量、任务优先级一起变动的时候那套事件监听状态同步的代码就会被拖进泥潭。而且每次业务方提一个新的可视化维度前端就得改一遍代码、重新走一遍测试发版流程。我这次想验证的是另一个思路让AI Agent成为建模和联动的中枢。Antigravity负责理解指令、拆解任务Blender MCP负责把Blender的建模能力变成AI能直接调用的工具。这样业务想要什么效果直接告诉AgentAgent自己去找模型、调参数、改状态整个链路的灵活度提升了一个量级。1.2 Antigravity 在这个项目里的定位Antigravity不是传统意义上的建模软件它是一个AI Agent运行环境。你可以把它理解成一个任务指挥官给它一个目标比如把一区货架的库存饱和度可视化出来它会自动拆解成若干子任务然后逐个执行。在仓储数字孪生这个场景里Antigravity主要承担三件事。第一理解业务意图把我们提出的可视化需求翻译成可执行的动作序列。第二调用MCP工具通过标准化的协议去操作Blender里的模型。第三处理异常比如某个货架ID找不到、库存数据缺失它有能力判断错误并调整策略。选Antigravity还有一个很实际的原因它的Agent执行过程是可见的每一步做了什么、调用了哪个工具、返回了什么结果都有日志。这个特性在调试阶段特别有用你不需要去猜AI到底理解了什么直接看执行轨迹就能定位问题。1.3 Blender MCP 把AI 指挥建模变成了现实Blender本身有一个非常完整的Python API也就是bpy理论上你可以用脚本控制Blender里的几乎所有操作。但问题是让一个不熟悉Blender的AI直接写bpy脚本它很容易写出已经废弃的API、或者忘掉必须先进入正确的模式才能编辑网格错误率非常高。Blender MCP在这里起到的作用是翻译官。它把Blender的常用操作封装成一个个语义清晰的工具函数比如创建长方体设置材质颜色移动物体复制物体等。AI不需要知道Blender内部API怎么调用只需要按MCP协议把一个工具名和参数JSON发过来Blender MCP Server就会去执行具体的bpy操作。这个设计模式我越想越觉得有价值。它其实是在AI和硬件/软件之间建立了一层语义接口AI不关心你是Blender还是Maya甚至不关心你是3D软件还是机械臂只要MCP Server把工具暴露成统一协议AI就能直接控制。2. 方案选型为什么是 MCP 协议以及为什么选 Blender2.1 MCP 到底是什么它解决的最本质问题是什么MCP的全称是Model Context Protocol模型上下文协议。它是一个开放标准定义了大模型应用如何与外部工具、数据源进行标准化交互。本质上MCP做的是把AI调用工具的接口这件事统一了。以前接入一个外部工具需要在代码里专门写一套集成逻辑比如调用某个Python函数、发出某个HTTP请求、解析某个私有格式的数据。每个工具一套玩法AI被硬编码在特定的工具链上换一个环境就失效。MCP的思路是建立起一个万能插座工具方按照MCP协议实现一个Server提供一系列工具AI侧通过MCP Client连接Server按协议去发现工具、调用工具、接收结果。工具侧和AI侧彻底解耦。我在项目里实测下来的感受是MCP的价值不只是省了对接时间更重要的是它让AI具备了可扩展的肢体。你给Blender装一个MCP ServerAI就具备操控Blender的能力给浏览器装一个MCP ServerAI就能自动化页面操作给数据库装一个AI就能查询数据。这种能力是可以叠加的你是做一个数字孪生项目还是自动化测试项目区别只在于你接入了哪些MCP Server。2.2 Antigravity 相比让 AI 直接生成 .py 脚本的优势有人问为什么不直接让AI写一个完整的Python脚本然后在Blender里运行这个思路我一开始也试过。提示词里把需求写清楚让AI输出一段代码我复制到Blender的Scripting工作区运行。这套流程有两个非常致命的问题。第一脚本是一次性的不灵活。业务方今天想看库存超过80%的货架标红明天改成超过60%就要闪烁提醒你每次都得让AI重新生成脚本、重新粘贴、重新运行。Antigravity的Agent模式不一样它是一个持续运行的智能体你随时给它下一个新指令它自己会去调用对应工具完成改动。第二脚本出错时排查成本高。AI生成的脚本经常有边界问题比如遍历物体时默认遍历了全部场景对象结果把不需要修改的模型也改了。在Antigravity的模式下每一步都是工具调用的形式操作有明确的对象作用域出错时能快速定位是哪一步的操作逻辑不对。2.3 在数字孪生早期阶段Blender 是比 Unity/Three.js 更顺手的建模端做数字孪生的3D展示层选型上通常有三条路Blender、Unity、Three.js或者其他WebGL框架。说实话每个方案都有它的适用场景但在项目早期、强数据驱动建模的阶段Blender的优势最明显。Blender是免费的对个人开发者和中小企业非常友好。它的Python API成熟且稳定几乎能把界面上的所有操作映射到底层接口。更关键的是Blender MCP生态已经有人在维护你能找到很多封装好的工具函数直接复用不用自己从头写。Unity更适合做高交互的实时应用、尤其是需要物理引擎和复杂动画的场合但它的工程结构重包体积大早期验证想法阶段体感很笨重。Three.js是纯Web方案适合做最终的产品化前端但它的建模能力很弱更多是把已有的3D模型加载到页面里展示而且数据联动逻辑还是得靠手工写代码。我的判断是Blender适合做数据到资产的构建环节Three.js适合做资产到用户的展示环节。前面提到的Through AntigravityBlender MCP做的是前者先把模型资产和业务数据绑定好后面如果要上线再把资产导出成Three.js能识别的格式。3. 环境准备与工具链搭建从零接入 Antigravity 和 Blender MCP3.1 Blender 版本选择和 Python 环境确认我用的Blender版本是4.1考虑到MCP相关插件和工具库的兼容性不建议用特别新的4.2或者特别老的3.x版本4.1是当前比较稳妥的选择。Blender启动后打开左侧的Scripting工作区确认Python控制台能够正常执行import bpy这是后面所有操作的基础。Blender内置的Python解释器是独立的不跟你系统里安装的Python共享包。所以当你需要给Blender安装第三方库时不能用pip直接装要指定Blender的Python解释器。这一步很多人会踩坑我一般用如下方式确认# 进入 Blender 自带的 Python 环境 /Applications/Blender.app/Contents/Resources/4.1/python/bin/python3.11 --versionWindows系统路径类似找到Blender安装目录下的python文件夹即可。确认好版本之后后面安装mcp、websockets等库时都会用到这个解释器。3.2 搭建 Blender MCP Server 并暴露建模工具Blender MCP Server的核心作用是把Blender的操作封装成MCP协议里的tools。我用的是社区里比较成熟的blender-mcp项目它会起一个WebSocket服务监听来自MCP Client的连接请求。先安装依赖# 假设你已经定位到 Blender 的 Python 解释器 blender_python -m pip install mcp websockets然后克隆项目代码在Blender的Scripting工作区里运行bpy_mcp_server.py这个脚本。运行后会看到控制台输出类似Blender MCP Server listening on ws://...的信息。这时候Blender已经变成了一个等待指令的MCP Server。接下来需要确认MCP Server暴露了哪些工具给AI调用。以blender-mcp为例常用的工具包括create_box创建立方体set_material设置物体材质和颜色move_object按坐标移动物体duplicate_object复制物体delete_object删除物体combine_meshes合并网格set_wireframe切换线框显示模式每个工具的输入参数都是结构化的JSON格式Antigravity就是通过这些参数理解你的意图并完成对Blender的控制。3.3 在 Antigravity 中配置 MCP 连接Antigravity侧需要把刚才启动的WebSocket服务地址配置进去。一般在Antigravity的设置里找到MCP相关的配置项添加一个新的连接填入服务地址。注意地址格式要完整包括协议前缀、IP、端口和路径缺失任何一部分都会导致握手失败。配置完成后可以做一个最简单的连通性测试。在Antigravity的对话框里输入在Blender中创建一个长宽高分别为2、4、1米的长方体命名为warehouse_base。如果链路没问题你会看到Antigravity调用了create_box工具参数也匹配了长方体的尺寸Blender视口里随即出现一个对应的几何体。3.4 首次联通时的关键配置检查清单我第一次联通的时候折腾了一个多小时最后发现是端口没有开放。如果用的是远程服务器需要检查防火墙是否放行了WebSocket端口如果是本机要确认Blender进程和Antigravity进程有没有运行在同一局域网段。另外检查一下Antigravity代理和连接服务有没有走不必要的中间节点MCP的WS握手对网络的干净度是有要求的。还有一个容易被忽略的点Antigravity的Node.js环境版本会直接影响MCP协议版本的协商。某些加密算法和帧格式在较老的Node版本下无法正常工作。建议Node版本至少保持在18以上安装前可以用node -v确认一下。4. 核心实现从空场景到完整仓储数字孪生4.1 先把仓储场景的数字需求理清楚开工之前最重要的一步是把需求讲透。这个仓储数字孪生要展示什么、服务谁、达到什么精细度这三个问题直接影响后续模型结构的设计。以我自己这个项目为例核心用户是仓储运营人员他们要看的是一区货架的库容情况、每台AGV的当前位置和状态、以及最近一小时出入库任务对应的货位变化。建模之前我列了一张简单的表对象属性联动数据货架排/列/层坐标承重容量库存量、库容上限货位具体格口位置类型是否占用、占用百分比AGV当前坐标任务路线电量、运行状态出入口相对位置任务批次、频率这张表决定了后面MCP工具的参数设计。比如我要让AI给某个货架按照库存占用比例批量设置颜色就需要工具接收货架编号和占用率两个参数。4.2 用 MCP 指令批量生成仓储基础模型正常情况下你不可能在Blender里手动放置几百个货架这会累死。我选择用Antigravity发布一个批量任务让AI循环调用create_box和move_object两个工具来生成货架阵列。比如我要求生成一个10排8列的货架区每排货架有4层层高0.6米。从交互上来讲我只需要在Antigravity对话框里用自然语言描述一遍任务它就会自行拆解成循环调用。第一次执行的时候我特别盯着中间过程AI确实在按规律的坐标间距生成模型没有跳排和乱序。这看起来简单但如果是让AI直接写python脚本很容易因为循环边界问题多建几个或者漏建几个且排查起来极费时间。批量建模的另外一个好处是你随时可以回退。Antigravity的每一步操作都有记录如果我观察到生成的货架密度太大会遮挡视线我可以让AI批量删除、重新调整间距。传统脚本方式要么全删重来要么手抄坐标去定位操作成本完全不在一个量级。4.3 库存数据如何绑定到货架模型的视觉状态模型建完后最核心的链路是把业务数据映射到模型上。简化一点说每个货架都对应一个货架编号我从仓储管理系统里导出一份JSON格式的库存数据包含货架编号和当前库存值。Antigravity需要做的就是读取这个JSON比对编号找到Blender里对应的物体再调用set_material改变它的材质颜色。实现这个逻辑的关键点在于编号的对应关系。前面建模时我给每个货架物体设置的名称就是rack_row01_col03这样JSON里的编号row01_col03就能直接关联。这种命名规范在数字孪生项目里非常重要它保证了AI在跨系统操作时有清晰的锚点。实际的MCP指令执行效果是库存占用率大于80%的货架变成红色50%到80%变成橙色低于50%保持深绿色。AI会先统计JSON里有多少货架的占用率超过阈值然后逐个调用材质更换工具。整个过程在场景规模500个货架以内的情况下执行效率非常高几乎感觉不到延迟。4.4 用数据驱动动画表现 AGV 路径和任务流转静态的仓储模型只能反映一个时刻的状态数字孪生的价值更体现在变化上。我的第二期目标是把AGV的运动轨迹和任务流转也放进场景里。Blender MCP在动效方面的工具相对基础但是配合数据驱动的方式也能实现。我先把一批AGV的轨迹点坐标整理成JSON数组AI根据轨迹点顺序逐个调用move_object。每一步移动之间加入一定的时间间隔视觉上就是AGV在库区间穿行。如果要更细腻一些还可以让AI对这些轨迹点做插值计算生成平滑的曲线运动路径。不过要提醒一下Blender的视图性能是会成为瓶颈的。如果场景里有几千个物体再加上频繁的动画更新视口会明显卡顿。我后来把不需要实时显隐的模型全部冻结了修改器并关闭了阴影投射才算把帧率稳定住。这一点在数字孪生项目里一定要提前规划不要等建到一半再返工。5. 踩坑记录Antigravity 执行终止、MCP 连接失败和 Blender 性能优化5.1 Antigravity Agent 执行到一半终止怎么办我在开发过程中遇到最多的一个问题就是antigravity agent execution terminated due to error。这个报错看起来吓人实际上绝大多数情况是Agent在执行某个工具时收到了异常返回而Agent无法自行恢复就终止了整条执行链。排查步骤我总结为三步。第一步到Antigravity的日志面板里找到对应任务的执行轨迹看具体是调用哪个工具的时候断的。我遇到过一次是AI在读取JSON文件时把文件路径写错了工具返回失败Agent直接终止。第二步检查Blender MCP Server的控制台输出看工具侧有没有打印出具体的Python堆栈信息。很多时候问题出在bpy调用本身比如参数里传了一个不存在的材质名称。第三步给MCP工具做防御性返回。就拿创建货架来说如果AI传入了负数尺寸工具应该返回一个明确的错误信息而不是让bpy抛出一个底层异常。工具返回的提示越清晰Agent下一步就越容易做出正确决策。5.2 MCP 连接失败/401/403 的排查思路MCP连接的底层走的是WebSocket协议所以一旦连接失败网络层面的排查思路和排查WebSocket逐一对应。首先检查地址前缀是不是wss://如果是http://或者ws://连接大概率会被拒。然后是token的有效期很多MCP Server需要带鉴权信息Antigravity需要在配置连接时填上有效的token过期后重新换取。还有一次遇到的是协议版本不兼容。Antigravity的MCP客户端和Blender MCP Server端对协议版本的要求不一致导致握手中断。解决办法是把双方都升级到最新版本然后重启Blender侧的Server进程。5.3 Blender 场景文件越来越大越来越卡Blender数字孪生项目做了一段时间后文件体积会迅速膨胀场景一复杂就拖慢视口刷新。这个问题很大程度是建模前期不注意清理造成的。比如用MCP工具批量创建模型后会残留大量材质槽、UV贴图和未使用的数据块这些对渲染毫无帮助却白白占着内存。我后来在每个操作阶段结束后都会主动调用Blender的清理逻辑。比如创建货架阵列完成后先用脚本遍历所有创建出来的物体去掉重复材质引用再执行bpy.ops.outliner.orphans_purge()清理孤立数据块。Antigravity虽然能驱动建模但它本身不具备审美洁癖所以定期打扫这个动作必须由人在工程层面把控。5.4 性能优化的具体操作清单如果你发现场景卡顿可以按我的优先级逐项检查。第一步关闭阴影投射仓储场景里绝大多数物体根本不需要投影。第二步调整材质球数量几百个货架不要每个都分配独立材质应该只保留几套标准材质轮换使用。第三步减少高模模型货架这种规则几何体用box就够了不需要引入圆柱体螺丝和圆弧倒角。第四步关闭视图环境光遮蔽Blender的视口着色设置里有一堆加重GPU负担的开销项目早期全部关掉。这套优化方案执行完之后我在一个4000多物体粒度的仓储场景里视口帧率从十几帧恢复到了比较流畅的水平。数据联动和视角旋转都顺滑了很多。现象排查顺序解决方案Agent执行中断定位到具体工具调用防御性参数校验工具返回明确错误信息MCP连接403检查地址协议和token更新鉴权信息确认没有跨域限制场景卡顿材质数量 阴影 网格密度合并材质关闭阴影清理孤立数据块视口闪退Blender版本兼容性换回4.1稳定版本移除缓存插件模型位置错乱坐标系沿袭错误统一世界坐标原点建模前先确认参考系6. 一点个人体会和下一步计划这个项目做到现在我最深的一个感受是AI驱动数字孪生建设的价值不在于它把建模变简单了多少而在于它把人与模型的交互方式彻底改变了。以前你面对一个复杂的3D场景只能通过鼠标和脚本去慢慢调整参数现在你可以直接用业务语言跟场景对话把这个区域改成暖色调同时把库存高的货架往前排显示AI会把你说的每一步落到具体工具操作上。它像一个熟悉Blender的实习生执行力强、有问必答、不抱怨加班只要你把需求描述清楚它就能交付一个相当可用的结果。当然它也不是万能的。Blender MCP目前的工具集合还没覆盖到刺客级建模技巧比如复杂的曲线放样、雕刻、粒子系统这些高级功能都有待开发。对于仓储数字孪生这种以规整几何体为主的场景来说现有工具已经够用了如果你要做流体力学模拟或者影视级特效那还是老老实实自己动手吧。标题是上这期我重点讲的是Antigravity Blender MCP的环境搭建和基础场景生成。下一期我计划深入讲几个进阶方向一是如何用Blender MCP实现仓储数据从CSV接入到模型状态的自动更新二是如何把Blender里做好的场景导出成Three.js能加载的glTF格式再接到前端页面上三是如何让Antigravity在无人值守模式下定期拉取业务数据去刷新场景状态。这几个方向做下来基本就是一个能应付实际业务演示的完整数字孪生小系统了。如果对这套组合拳感兴趣建议你拿一个简单的仓储布局开始试先跑通一条链路再逐渐加数据维度和视觉维度。