做了一个 Cocos MCP 插件,让 AI 参与场景编辑、UI 制作和预览调试
大家好,最近在持续开发一个 Cocos Creator 扩展:Cocos MCP Bridge。想在论坛分享一下它解决的问题和目前的实现思路,也欢迎大家提建议。
做 Cocos 项目时,很多工作需要反复在编辑器里操作:创建节点、调整组件、绑定资源、保存 Prefab、打开预览检查效果。AI 可以帮我们写代码,但如果它看不到编辑器里的实际状态,很多操作最终还是要靠开发者手动完成。
我想尝试解决的是:能不能让 AI 在理解当前工程状态的基础上,参与编辑器操作,并在执行后检查结果?
Cocos MCP Bridge 通过 MCP 协议连接 Creator 和 Cursor 等兼容的 AI 客户端,让 AI 可以调用编辑器工具,读取场景和资源信息,并在开放的范围内执行操作。
商城地址:Cocos MCP Bridge 商品页
它可以做什么?
目前 2.1.8 版本内置 395 个 MCP 工具,分为 14 个功能分组,主要覆盖:
-
场景与节点:查看层级、创建节点、调整组件和属性。
-
UI 与 Prefab:根据规格搭建界面,编辑和保存 Prefab,检查结构、尺寸和文本设置。
-
资源管理:导入和刷新资源,查询引用,处理 SpriteFrame、Bundle 和 Auto Atlas。
-
预览调试:读取浏览器预览中的运行时节点树、日志和画面,辅助定位问题。
-
构建相关:读取构建面板参数、发起构建并查询任务状态。
-
自定义工具:将团队自己的 Creator 扩展或业务工具接入 MCP。
其中默认启用的 13 个分组包含 394 个工具,另有 1 个高危工具默认关闭。实际可见和可执行的工具还会受到分组开关、连接状态、Creator 版本以及当前编辑或预览上下文的影响。
工具数量只是覆盖范围的一个参考。我更希望它能帮助大家完成一段连续的工作:先读取工程状态,再操作、保存,最后通过回读和预览检查结果。
一个使用场景:搭建奖励弹窗
比如要制作一个奖励弹窗,可以先给 AI 一个明确的任务:
请先检查当前工程的 UI 结构和资源目录,然后创建一个奖励弹窗 Prefab,包含标题、奖励列表和领取按钮。完成后保存 Prefab,检查节点、组件和文本设置,并在预览中查看实际效果。
在这个过程中,AI 可以调用 Bridge 查询工程、创建和调整节点、设置组件、绑定资源,再检查保存结果。
2.1.8 版本增加了 UI 适配审查提示:根据页面、弹窗或列表项等不同场景,提醒检查 Widget、Layout、脚本适配或固定构图;对于可能重复的列表 Item,也会提示考虑 Prefab 复用。
这些提示是辅助检查,不能替代不同分辨率和设备上的实际验收。UI 是否符合设计、交互是否正确,仍然需要结合预览和项目需求确认。
为什么强调操作后的验证?
做编辑器自动化时,工具返回结果,并不一定代表最终状态符合预期。组件是否挂到了目标节点?资源引用是否正确?Prefab 是否保存成功?当前操作的是场景、Prefab 编辑模式,还是运行中的预览?
Bridge 在相关工具中加入了编辑上下文识别、状态回读、写入结果检查和错误反馈。面板也提供活动记录,方便查看 AI 调用了哪些工具、流程在哪一步出现问题。
它不能保证所有任务都自动完成,但希望让过程更容易观察和排查。涉及重要修改时,仍建议做好版本管理,并结合实际预览与业务测试验收。
编辑态和运行时可以一起用
安装预览 Runtime 后,可以在浏览器预览期间读取运行时节点树、查看日志、检查或调整属性。排查问题时,AI 可以参考实际运行状态,而不只是猜测编辑器里的配置。
这里有一个使用上的区别:编辑态场景树和 Play 态运行时节点树不是同一份状态。调试运行中的问题时,需要使用运行时工具,并先确认预览 Runtime 在线。
也可以接入自己的插件和团队工具
除了内置能力,Bridge 还支持注册自定义 MCP 工具。
如果团队已经有 Creator 扩展,可以将已有的 Editor.Message 接口封装成 MCP 工具;也可以为项目新增专用工具,让 AI 在同一个流程中调用。原有的人工操作面板可以继续保留。
例如,团队可以把内部的资源检查、配置处理或关卡工具接入进来,让 AI 先调用业务工具处理数据,再通过 Bridge 完成资源导入、场景配置和预览检查。
第三方插件不会因为安装了 Bridge 就自动具备 MCP 能力:插件需要提供可调用接口,或者由有权限的开发者完成适配。自定义扩展和工具也可以分别控制是否对 AI 开放。
目前也有一些支持接入的独立扩展,例如 UI 与动效素材库、字体工具、资源流水线工具和行为树工具。它们是独立产品,需按需分别安装和授权;具体可调用范围以安装版本为准。
安装与使用
目前的环境要求:
-
Cocos Creator 3.8.0 及以上,推荐 3.8.8;其他小版本建议结合项目验证。
-
Node.js 20 及以上,用于运行 MCP Sidecar。
-
支持 MCP 的 AI 客户端,例如 Cursor。
基本步骤:
-
将扩展安装到工程的
extensions/cocos-mcp-bridge/目录,并在 Creator 扩展管理器中启用。 -
打开 扩展 → Cocos MCP Bridge,在「网关」页启动网关。
-
在「配置客户端」中生成或复制 MCP 配置,然后在 AI 客户端启用或重载。
-
先让 AI 执行一次工程信息或场景树查询,确认连接到了预期的 Creator 工程。
-
需要调试浏览器预览时,再安装预览 Runtime 并确认其在线。
网关默认绑定本机,默认地址为 127.0.0.1:9160。如果端口被占用,会自动递增,配置时请以面板显示的实际端口为准。
想听听大家的意见
我目前比较关注的方向,是让 AI 参与 Cocos 的日常制作流程,同时让操作结果可检查、问题可追踪。
也想请教大家:
-
你们在 Cocos 开发中,最希望交给 AI 处理的重复工作是什么?
-
场景编辑、UI 搭建、资源整理和运行时调试,哪个方向对你帮助最大?
-
如果团队已经有自己的编辑器工具,你们希望 AI 怎样调用它们?
欢迎分享使用场景和遇到的问题,我会结合反馈继续完善。
商城地址:Cocos MCP Bridge 商品页
交流与反馈: QQ:2225466148;维护 QQ 群:920612747。
本文基于 Cocos MCP Bridge 2.1.8;具体功能和兼容范围以实际安装版本及商城更新说明为准。