DC-COCO-MCP

DC-COCO-MCP 是一个 clean-room 自研的 Cocos Creator MCP 扩展，用于让 AI 客户端通过 MCP 调用控制 Cocos Creator 编辑器中的项目、场景、节点、组件、资源、Prefab、构建和诊断流程。

本项目目标是成为 Cocos Creator 日常开发工具，而不是商业插件源码的反编译版本。

当前状态

• Cocos Creator 兼容目标：3.8.8 优先，保留 >=3.7.0 的兼容意图。
• MCP endpoint：默认 http://127.0.0.1:3000/mcp。
• 语言与工具链：TypeScript、pnpm、@modelcontextprotocol/sdk。
• 当前实现范围：P0-P4 基础能力、操作安全、组件 schema、资源系统、Builder 生产化和面板控制台的第一版。

已实现能力

• Cocos Creator 扩展壳：菜单、面板、生命周期、设置、日志、服务启停、场景脚本。
• MCP HTTP 服务：支持 initialize、tools/list、tools/call。
• 统一工具返回：ok、data、changeSummary、warnings、errors、artifacts。
• 场景与节点：项目信息、场景树、节点查找、节点信息、创建、更新、删除、重挂父节点。
• 组件：组件列表、添加、更新、删除、schema 查询和参数校验。
• 资源：搜索、信息、.meta、刷新、依赖、被依赖、移动、删除、导入图片、SpriteFrame 解析。
• Prefab：创建、实例化、信息读取、保存、解绑。
• Builder：预设、运行、状态、日志、诊断、输出目录打开和清理。
• 操作安全：操作历史、备份、撤销、dry-run、批量预览。
• 面板控制台：项目状态、MCP 状态、工具管理、常用动作、日志诊断。

Clean-room 边界

本项目只做功能级自研实现：

• 不反混淆商业插件。
• 不复制商业插件源码、UI、授权逻辑、sidecar 或加密载荷。
• 功能设计依据来自公开 Cocos Creator 扩展 API、公开 MCP 协议、公开文档和自研能力拆解。

安装与开发

pnpm install
pnpm typecheck
pnpm build
pnpm test
pnpm lint

开发构建完成后，把项目目录作为 Cocos Creator 扩展放入目标项目的 extensions/dc-coco-mcp，或使用符号链接指向本仓库。

常用命令

pnpm build
pnpm typecheck
pnpm test
pnpm lint
pnpm smoke

验收报告

完整阶段性实现与验收记录见：

• IMPLEMENTATION_REPORT.md

许可证

当前仓库公开可见，但还没有授予开源许可证。未经作者明确授权，不应复制、分发或商用本项目代码。