Repository navigation
Releases: iEfoam/CocosMcp
Release list
CocosMCP v0.1.0-dev.23.6f07e38
Verified development build from source fingerprint b340acefb8c9d806e7f818af6b1e66807a5b878667a2d2411f3c984a80e20c09.
可靠性、UI 与 Prefab 优化 / Reliability, UI and Prefab improvements
本次交付 O01–O15 优化及其必要的 UI 编排、样式和 Creator 登录复用依赖：
- 证据导出并发与容量守卫，写后未知结果账本，独立诊断/取消通道，原子恢复日志。
- 输出契约、网关配额、按范围资源扫描、请求阶段计时、日志与构建历史管理。
- Creator 3.8.8 UI 结构计划/执行、Prefab 资源编辑及实例挂载节点/组件覆盖；整组 Undo/Redo 和保存重开。
- Prefab 差异与 guarded apply/restore、缺失脚本保护、UUID/字面路径/动态未知审查。
- 开发/原生/发布构建档位、共享 CI 验证、只读检查与独立发布权限、不可覆盖候选包。
发布准备前本地自动测试 534/534 通过。原生证据包括 Creator 3 UI 15/15、Creator 2 14/14，以及本轮 Creator 3 Prefab 资源/实例专项；各自适用其记录的源码检查点，不表示全部能力均获当前原生验证。此 Release 由 CI 对发布提交重新检查和构建。
Prefab 实例源节点移动/删除需进入资源编辑模式；嵌套实例、压缩嵌套差异、动态字符串引用仍保留明确限制。未部署到用户工程或服务器。详见 交付清单。
Local pre-release validation passed 534 automated tests. Native acceptance is fixture- and source-checkpoint-specific: Creator 3 UI 15/15, Creator 2 14/14, plus focused Creator 3 Prefab asset/instance persistence and Undo/Redo checks. CI verifies this release commit independently. Nested Prefab overrides and dynamic reference rewriting retain documented limits. No project or server deployment is included.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.
CocosMCP v0.1.0-dev.22.0ec11b6
Verified development build from source fingerprint cf9019b296f2b4fe10504403b51798462f37c65b87b1d6b5f913a13441c4a6d6.
可靠性、UI 与 Prefab 优化 / Reliability, UI and Prefab improvements
本次交付 O01–O15 优化及其必要的 UI 编排、样式和 Creator 登录复用依赖：
- 证据导出并发与容量守卫，写后未知结果账本，独立诊断/取消通道，原子恢复日志。
- 输出契约、网关配额、按范围资源扫描、请求阶段计时、日志与构建历史管理。
- Creator 3.8.8 UI 结构计划/执行、Prefab 资源编辑及实例挂载节点/组件覆盖；整组 Undo/Redo 和保存重开。
- Prefab 差异与 guarded apply/restore、缺失脚本保护、UUID/字面路径/动态未知审查。
- 开发/原生/发布构建档位、共享 CI 验证、只读检查与独立发布权限、不可覆盖候选包。
发布准备前本地自动测试 534/534 通过。原生证据包括 Creator 3 UI 15/15、Creator 2 14/14，以及本轮 Creator 3 Prefab 资源/实例专项；各自适用其记录的源码检查点，不表示全部能力均获当前原生验证。此 Release 由 CI 对发布提交重新检查和构建。
Prefab 实例源节点移动/删除需进入资源编辑模式；嵌套实例、压缩嵌套差异、动态字符串引用仍保留明确限制。未部署到用户工程或服务器。详见 交付清单。
Local pre-release validation passed 534 automated tests. Native acceptance is fixture- and source-checkpoint-specific: Creator 3 UI 15/15, Creator 2 14/14, plus focused Creator 3 Prefab asset/instance persistence and Undo/Redo checks. CI verifies this release commit independently. Nested Prefab overrides and dynamic reference rewriting retain documented limits. No project or server deployment is included.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.
CocosMCP v0.1.0-dev.21.83fa412
Tested development build from commit 83fa4122d0b31d20c2bf5475996b5abaa237f4cd.
预览优化 / Preview improvements
CP-001～013 已实现：Creator 2/3 完整 runtime 包及 SHA 健康检查、当前场景/帧证据、真实输入、横屏预设、加载字节刷新、就绪与诊断、脱敏审计、语义点击、验收配方、夹具清理和生命周期回归。启动器沿用本地凭据和已有会话。
Implemented CP-001–013: complete runtime packages and integrity checks, current scene/frame evidence, real input, landscape presets, loaded-byte refresh, readiness/diagnostics, sanitized auditing, semantic clicks, recipes, guarded fixtures and lifecycle regression. Launchers reuse local credentials and existing sessions.
最新源码本地验证为 333 项自动测试、Creator 2 原生 14/14、Creator 3 原生 12/14；3.8.8 隐藏窗口输入后态未知且配方成功断言未通过。此前两版 14/14 记录按原指纹保留，不作为当前源码全通过证明。CI 按本 Release 的提交重新验证。Creator 2 场景字节证明仍可 unknown，外部 Chrome MCP、真实设备和真实匹配/资金未验证。详见 预览验收指南。Creator 2 旧七文件更新器需用完整 ZIP/安装器升级，不继续分发缺 runtime 的旧清单。
Latest local checks: 333 automated tests, Creator 2 native 14/14, and Creator 3 native 12/14. Creator 3 hidden-window input has an unknown outcome, and its recipe did not meet the success assertion. Earlier 14/14 results retain their original source fingerprint. CI rechecks this release's source. Creator 2 scene byte proof may remain unknown; external Chrome MCP, physical devices and real business/payment flows remain unverified. Legacy seven-file Creator 2 updaters require the full ZIP/installer upgrade.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.
CocosMCP v0.1.0-dev.19.e357077
Tested development build from commit e3570777f777e5fa3360148f8c61312a51d21e6a.
预览优化 / Preview improvements
CP-001～013 已实现：Creator 2/3 完整 runtime 包及 SHA 健康检查、当前场景/帧证据、真实输入、横屏预设、加载字节刷新、就绪与诊断、脱敏审计、语义点击、验收配方、夹具清理和生命周期回归。启动器沿用本地凭据和已有会话。
Implemented CP-001–013: complete runtime packages and integrity checks, current scene/frame evidence, real input, landscape presets, loaded-byte refresh, readiness/diagnostics, sanitized auditing, semantic clicks, recipes, guarded fixtures and lifecycle regression. Launchers reuse local credentials and existing sessions.
最新源码本地验证为 333 项自动测试、Creator 2 原生 14/14、Creator 3 原生 12/14；3.8.8 隐藏窗口输入后态未知且配方成功断言未通过。此前两版 14/14 记录按原指纹保留，不作为当前源码全通过证明。CI 按本 Release 的提交重新验证。Creator 2 场景字节证明仍可 unknown，外部 Chrome MCP、真实设备和真实匹配/资金未验证。详见 预览验收指南。Creator 2 旧七文件更新器需用完整 ZIP/安装器升级，不继续分发缺 runtime 的旧清单。
Latest local checks: 333 automated tests, Creator 2 native 14/14, and Creator 3 native 12/14. Creator 3 hidden-window input has an unknown outcome, and its recipe did not meet the success assertion. Earlier 14/14 results retain their original source fingerprint. CI rechecks this release's source. Creator 2 scene byte proof may remain unknown; external Chrome MCP, physical devices and real business/payment flows remain unverified. Legacy seven-file Creator 2 updaters require the full ZIP/installer upgrade.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.
CocosMCP v0.1.0-dev.18.b3e9100
Tested development build from commit b3e91005dfb84885599e7e669f526923b61f2061.
预览优化 / Preview improvements
CP-001～013 已实现：Creator 2/3 完整 runtime 包及 SHA 健康检查、当前场景/帧证据、真实输入、横屏预设、加载字节刷新、就绪与诊断、脱敏审计、语义点击、验收配方、夹具清理和生命周期回归。启动器沿用本地凭据和已有会话。
Implemented CP-001–013: complete runtime packages and integrity checks, current scene/frame evidence, real input, landscape presets, loaded-byte refresh, readiness/diagnostics, sanitized auditing, semantic clicks, recipes, guarded fixtures and lifecycle regression. Launchers reuse local credentials and existing sessions.
最新源码本地验证为 333 项自动测试、Creator 2 原生 14/14、Creator 3 原生 12/14；3.8.8 隐藏窗口输入后态未知且配方成功断言未通过。此前两版 14/14 记录按原指纹保留，不作为当前源码全通过证明。CI 按本 Release 的提交重新验证。Creator 2 场景字节证明仍可 unknown，外部 Chrome MCP、真实设备和真实匹配/资金未验证。详见 预览验收指南。Creator 2 旧七文件更新器需用完整 ZIP/安装器升级，不继续分发缺 runtime 的旧清单。
Latest local checks: 333 automated tests, Creator 2 native 14/14, and Creator 3 native 12/14. Creator 3 hidden-window input has an unknown outcome, and its recipe did not meet the success assertion. Earlier 14/14 results retain their original source fingerprint. CI rechecks this release's source. Creator 2 scene byte proof may remain unknown; external Chrome MCP, physical devices and real business/payment flows remain unverified. Legacy seven-file Creator 2 updaters require the full ZIP/installer upgrade.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.
CocosMCP v0.1.0-dev.17.091a16f
Tested development build from commit 091a16f1f634f492419b76048edee80293ed764a.
预览优化 / Preview improvements
CP-001～013 已实现：Creator 2/3 完整 runtime 包及 SHA 健康检查、当前场景/帧证据、真实输入、横屏预设、加载字节刷新、就绪与诊断、脱敏审计、语义点击、验收配方、夹具清理和生命周期回归。启动器沿用本地凭据和已有会话。
Implemented CP-001–013: complete runtime packages and integrity checks, current scene/frame evidence, real input, landscape presets, loaded-byte refresh, readiness/diagnostics, sanitized auditing, semantic clicks, recipes, guarded fixtures and lifecycle regression. Launchers reuse local credentials and existing sessions.
最新源码本地验证为 333 项自动测试、Creator 2 原生 14/14、Creator 3 原生 12/14；3.8.8 隐藏窗口输入后态未知且配方成功断言未通过。此前两版 14/14 记录按原指纹保留，不作为当前源码全通过证明。CI 按本 Release 的提交重新验证。Creator 2 场景字节证明仍可 unknown，外部 Chrome MCP、真实设备和真实匹配/资金未验证。详见 预览验收指南。Creator 2 旧七文件更新器需用完整 ZIP/安装器升级，不继续分发缺 runtime 的旧清单。
Latest local checks: 333 automated tests, Creator 2 native 14/14, and Creator 3 native 12/14. Creator 3 hidden-window input has an unknown outcome, and its recipe did not meet the success assertion. Earlier 14/14 results retain their original source fingerprint. CI rechecks this release's source. Creator 2 scene byte proof may remain unknown; external Chrome MCP, physical devices and real business/payment flows remain unverified. Legacy seven-file Creator 2 updaters require the full ZIP/installer upgrade.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.
CocosMCP v0.1.0-dev.16.0b04351
Tested development build from commit 0b04351e4ea5bf265b59e90371695b1d721959f0.
预览优化 / Preview improvements
CP-001～013 已实现：Creator 2/3 完整 runtime 包及 SHA 健康检查、当前场景/帧证据、真实输入、横屏预设、加载字节刷新、就绪与诊断、脱敏审计、语义点击、验收配方、夹具清理和生命周期回归。启动器沿用本地凭据和已有会话。
Implemented CP-001–013: complete runtime packages and integrity checks, current scene/frame evidence, real input, landscape presets, loaded-byte refresh, readiness/diagnostics, sanitized auditing, semantic clicks, recipes, guarded fixtures and lifecycle regression. Launchers reuse local credentials and existing sessions.
最新源码本地验证为 333 项自动测试、Creator 2 原生 14/14、Creator 3 原生 12/14；3.8.8 隐藏窗口输入后态未知且配方成功断言未通过。此前两版 14/14 记录按原指纹保留，不作为当前源码全通过证明。CI 按本 Release 的提交重新验证。Creator 2 场景字节证明仍可 unknown，外部 Chrome MCP、真实设备和真实匹配/资金未验证。详见 预览验收指南。Creator 2 旧七文件更新器需用完整 ZIP/安装器升级，不继续分发缺 runtime 的旧清单。
Latest local checks: 333 automated tests, Creator 2 native 14/14, and Creator 3 native 12/14. Creator 3 hidden-window input has an unknown outcome, and its recipe did not meet the success assertion. Earlier 14/14 results retain their original source fingerprint. CI rechecks this release's source. Creator 2 scene byte proof may remain unknown; external Chrome MCP, physical devices and real business/payment flows remain unverified. Legacy seven-file Creator 2 updaters require the full ZIP/installer upgrade.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.
CocosMCP v0.1.0-dev.14.9a7b11b
Tested development build from commit 9a7b11bd2be19d6acdfe86b782add33712f64a8c.
预览优化 / Preview improvements
CP-001～013 已实现：Creator 2/3 完整 runtime 包及 SHA 健康检查、当前场景/帧证据、真实输入、横屏预设、加载字节刷新、就绪与诊断、脱敏审计、语义点击、验收配方、夹具清理和生命周期回归。启动器沿用本地凭据和已有会话。
Implemented CP-001–013: complete runtime packages and integrity checks, current scene/frame evidence, real input, landscape presets, loaded-byte refresh, readiness/diagnostics, sanitized auditing, semantic clicks, recipes, guarded fixtures and lifecycle regression. Launchers reuse local credentials and existing sessions.
最新源码本地验证为 333 项自动测试、Creator 2 原生 14/14、Creator 3 原生 12/14；3.8.8 隐藏窗口输入后态未知且配方成功断言未通过。此前两版 14/14 记录按原指纹保留，不作为当前源码全通过证明。CI 按本 Release 的提交重新验证。Creator 2 场景字节证明仍可 unknown，外部 Chrome MCP、真实设备和真实匹配/资金未验证。详见 预览验收指南。Creator 2 旧七文件更新器需用完整 ZIP/安装器升级，不继续分发缺 runtime 的旧清单。
Latest local checks: 333 automated tests, Creator 2 native 14/14, and Creator 3 native 12/14. Creator 3 hidden-window input has an unknown outcome, and its recipe did not meet the success assertion. Earlier 14/14 results retain their original source fingerprint. CI rechecks this release's source. Creator 2 scene byte proof may remain unknown; external Chrome MCP, physical devices and real business/payment flows remain unverified. Legacy seven-file Creator 2 updaters require the full ZIP/installer upgrade.
安装 / Installation
推荐：让 AI 自动下载安装 — 直接复制提示词，AI 自动识别工程、从 GitHub 下载、安装、配置并验证连接，无需先手动准备 ZIP 或路径。
Recommended: AI-assisted automatic installation — copy the prompt; let AI discover the project, download from GitHub, install, configure and verify the connection.
以下为手动安装方式 / Manual installation follows.
| Creator | 下载 ZIP / Download | 工程内目录 / Project directory |
|---|---|---|
| 2.x | cocos-mcp-creator2.zip |
packages/cocos-mcp-creator2/ |
| 3.x | cocos-mcp-creator3.zip |
extensions/cocos-mcp-creator3/ |
- 准备 Cocos Creator 与 Node.js 24+，用同版本
SHA256SUMS核对 ZIP。升级前停止 MCP 服务、关闭 Creator 并备份旧扩展。 - 将 ZIP 内容解压到对应目录，确保
package.json直接位于该目录内。 - 在扩展根目录新建
service-config.json，设置nodeExecutable为本机 Node.js 24+ 的绝对路径。发布 ZIP 不包含这份本机配置。 - 打开工程，通过 CocosMCP → 打开控制中心 → 启动 MCP 服务 启动服务，再用面板地址及本机 Bearer token 配置 AI 客户端的 Streamable HTTP MCP。
For offline installation, have Creator and Node.js 24+ available, verify the ZIP with SHA256SUMS, and extract it into the matching project directory above. Back up an existing extension before replacement. Create service-config.json beside package.json, setting nodeExecutable to your local Node executable's absolute path. Load the extension and start MCP from the control center, then configure your AI client's Streamable HTTP connection using the displayed endpoint and local Bearer token.
English installation guide · AI installation prompt
*.full.json and the other Creator JSON bundles are for the plugin updater, not manual editor installation. GitHub's Source code archives need compilation. ZIP and update bundles share the same source fingerprint. Pre-release builds are development versions and are not installed automatically by the stable updater.