分享一个自己做的开源插件:把大模型接进 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 依赖、无构建步骤。
▌怎么用
- 把文件夹丢进工程 extensions/ 目录,菜单出现「Cocos MCP → Open Panel」
- 首次在 server 目录建 Python 环境(需 Python 3.10+,国内记得加清华/阿里镜像)
- 面板点 Start Server → Connect,绿点亮即连通
- 在 Claude Desktop / Cursor 里配上这个 MCP 服务器即可
(适配 Cocos Creator 3.8.0+;另有 2.4.x 版本)
▌开源地址(免费,MIT)
https://github.com/shiliyu1991-lang/cocos-mcp-3x
README 里有完整安装、端口说明和常见问题。欢迎试用、提 issue、点 star~
