【开源】让 AI 直接操控 Cocos Creator 3.8 编辑器 —— MCP 插件分享

分享一个自己做的开源插件:把大模型接进 Cocos Creator 3.8.x 编辑器,
让 AI(Claude Desktop / Cursor 等 MCP 客户端)能真正“动手”操作你的工程,
而不只是聊天给建议。

▌它能让 AI 做什么
· 读写当前场景里的节点(位置/旋转/显隐/颜色,以及组件属性,多按 uuid 操作)
· 检视和操作 assets/ 下的资源(asset-db)
· 列出/打开/保存场景(3.x 的 .scene)
· 读取编辑器控制台报错(500 条环形缓冲)
· 在编辑器主上下文或场景上下文执行任意 JS(强力逃生舱)
· 查工程信息:路径、版本、场景列表、可用命令

▌原理(一句话)
插件内置一个 Python MCP 服务器,通过本地 WebSocket 桥和 Cocos 扩展通信;
MCP 客户端调用工具 → 服务器转发 → 扩展用 Editor.Message.request 执行编辑器操作。
插件自包含:服务器就打包在插件里,扩展本身零 npm 依赖、无构建步骤。

▌怎么用

  1. 把文件夹丢进工程 extensions/ 目录,菜单出现「Cocos MCP → Open Panel」
  2. 首次在 server 目录建 Python 环境(需 Python 3.10+,国内记得加清华/阿里镜像)
  3. 面板点 Start Server → Connect,绿点亮即连通
  4. 在 Claude Desktop / Cursor 里配上这个 MCP 服务器即可

(适配 Cocos Creator 3.8.0+;另有 2.4.x 版本)

▌开源地址(免费,MIT)
https://github.com/shiliyu1991-lang/cocos-mcp-3x

README 里有完整安装、端口说明和常见问题。欢迎试用、提 issue、点 star~

5赞

mark!

谢谢分享,

我是弄了个python脚本实时解析查询
但ui都是自已操作, 目前LLM好像还没聪明到不会出错

mark,给大佬点赞

谢谢支持!你这个思路其实和我一致——只读的解析 / 查询是目前 LLM 最靠谱的场景,让它帮你"看"和"查"基本不出错,真正容易翻车的是"动手改"。

这套 MCP 我也是按这个分工做的:模型走的是编辑器 API(Editor.Message.request)做结构化操作,而不是去模拟点 UI,所以比界面自动化稳一些,出错也好定位、好回滚,配合 read_console 能实时看到反馈。实际用的时候我一般让它多做检视 / 批量查询,写操作要么小步来、要么我自己把最后一道关——human-in-the-loop 现阶段还是省心。

你那个实时解析的 Python 脚本听着挺实用,方便的话可以聊聊你是怎么解析的,互相参考下 👍
1赞

那么 我推荐我这个功能更多一点 让 AI 接管 Cocos:MCP 交出编辑器,CLI 离线改 prefab

的确不错,可以学习下

其实就是个上千行的python脚本
读json进来, 再读相关的设定档
利用dict映射,转换成人/LLM看得懂的样式而已

如果你有兴趣我可以发你一份
但对你来说应该参考价值不大, 毕竟你这个比我的更完整

取长补短 :sunglasses:

OK,已经发了

大佬牛逼!