做了一个 Cocos MCP 插件,让 AI 参与场景编辑、UI 制作和预览调试

做了一个 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。

基本步骤:

  1. 将扩展安装到工程的 extensions/cocos-mcp-bridge/ 目录,并在 Creator 扩展管理器中启用。

  2. 打开 扩展 → Cocos MCP Bridge,在「网关」页启动网关。

  3. 在「配置客户端」中生成或复制 MCP 配置,然后在 AI 客户端启用或重载。

  4. 先让 AI 执行一次工程信息或场景树查询,确认连接到了预期的 Creator 工程。

  5. 需要调试浏览器预览时,再安装预览 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;具体功能和兼容范围以实际安装版本及商城更新说明为准。

我不知道为什么都这么喜欢mcp,我自己是做成cli工具。

现在codex可以支持到一个效果图和散图给你搭出来基本上百分之98完整的预制体
如果没有效果图个散图 也可以根据功能描述的提示词 让codex给你生成出来效果图和散图在搭出来预制体 我不知道还费劲搞mcp干嘛?

mcp作为一个中转站,可以嵌入其他自定义插件,配合skill,基本可以99%还原设计稿,且不是单纯的还原,支持适配和子项预制体提取等,反正我感觉目前使用下来挺好的。而且排查问题挺方便的,当然cli也可以,本质上mcp就是调用Cocos的相关命令。不过我觉得可以在mcp上做更多的工作,而不是只把它当作一个只提供命令集的工具,而是应该把它当成一个Cocos技能集专家,他配合ai可以更好的完成问题

mcp和cli一样都只是个api/接口而已,把引擎能力暴露给agent使用。
mcp有规范/协议,通用性好。
你喜欢直接让agent修改项目文件也可以,给个接口可以对一些东西做更规范的约束。
像游戏画面截屏,没有接口你agent怎么拿得到?