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

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

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

▌原理(一句话)
插件内置一个 Python MCP 服务器,通过本地 WebSocket 桥和 Cocos 扩展通信;
MCP 客户端调用工具 → 服务器转发 → 扩展用 cc 引擎在场景进程里真正执行。
插件自包含:服务器就打包在插件里,扩展本身零 npm 依赖、无构建步骤。

▌怎么用

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

(在 Cocos Creator 2.4.15 上开发验证,理论适配整个 2.4.x;另有 3.8.x 版本)
▌开源地址(免费,MIT)
https://github.com/shiliyu1991-lang/cocos-mcp-2x

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

1赞