The Most Advanced MCP Server for Cocos Creator Editor with `execute_javascript`, prompts/resources, screenshots, asset dependency validation, tool profiles, one-click client configuration, and editor automation.

Funplay MCP for Cocos – AI 対応 Cocos Creator 扩展

概要 – MIT ライセンスの Cocos Creator 编辑器扩展名で、编辑器内に埋め込み HTTP MCP（Machine‑Code‑Protocol）服务器を実行します。この服务器により、AI 编码助手（Claude Code、Cursor、VS Code Copilot 等）は execute_javascript などのツールを呼び出して、Cocos 项目を实时に检查或修改できます。

核心概念

扩展启动一个本地 HTTP JSON‑RPC 端点（默认端口 8765，或项目派生的端口在 20000‑29999 范围内）。
AI 客户端连接到该端点并调用 MCP 工具 – 预定义的操作，可以在场景或编辑器中运行 JavaScript、读取资源、捕获截图、列出场景等。
主要工具是 execute_javascript，它可以在场景运行时或 编辑器 UI 上下文中运行任意 JavaScript。
所有其他工具都基于此构建，为 AI 代理自动化 UI 创建、资源检查、调试等提供了一个紧凑但强大的表面。

主要功能

功能	它为你提供什么
嵌入式服务器	无需外部守护进程；MCP 服务器位于 Cocos Creator 扩展内部，并从编辑器菜单（`Funplay > MCP Server`）启动/停止。
一键客户端配置	面板为流行的 AI 助手（Claude Code、Cursor、VS Code、Trae、Kiro、Qoder、Kimi Code、Codex、OpenCode）写入即用型 JSON‑RPC 配置片段。
两个执行上下文	`context: "scene"` 在活动游戏场景中运行 JavaScript；`context: "editor"` 在编辑器/浏览器 UI 中运行。
工具配置文件	`core`（39 个高信号工具）、`full`（106 个工具）或自定义配置文件，你可以启用/禁用类别。
安全检查	默认阻止危险的文件系统或 shell 调用；如果你接受风险，可以在每次调用时禁用。
截图和输入模拟	捕获编辑器、场景或预览截图，并将鼠标/键盘事件发送回 AI 客户端。
全局安装选项	为所有 Cocos Creator 项目安装一次；扩展从 GitHub 发布自动更新并验证 SHA‑256 校验和。
调试辅助	简单的 `GET /health` 和 `GET /tools` 端点用于快速 curl 检查；面板内提供最近活动日志视图。
npm stdio 包装器	可选的 `funplay-cocos-mcp` 命令，将基于 stdio 的 MCP 客户端桥接到嵌入式 HTTP 服务器。

典型工作流程

安装 – 通过 Cocos Store 或克隆仓库到项目的 extensions/ 文件夹（或使用 Install for All Projects 按钮）。
启动服务器 – Funplay > MCP Server → 启用。面板显示确切的 URL 和端口。
配置 AI 客户端 – 为 Claude Code、Cursor 等点击 One‑Click Configure；扩展将正确的 JSON‑RPC 条目写入客户端的配置文件。
发送请求 – 从 AI 助手中，要求它运行 execute_javascript（例如，创建登录 UI、列出资源、捕获截图）。助手接收 JSON‑RPC 响应，可以检查结果并进行迭代。
迭代 – 使用 Recent Activity 视图查看每次调用、其控制台输出以及任何返回的数据。

谁应该使用它

游戏开发者，他们已经在 Cocos Creator 中工作，并希望 AI 驱动的代码生成、UI 原型设计或自动化调试。
AI 助手开发者，寻找一个现成的 MCP 端点来测试他们的工具与真实编辑器环境的交互。
工具构建者，需要一个稳定的 JSON‑RPC 表面来编写 Cocos 场景脚本，而无需编写自定义插件。

成熟度与状态

版本控制 – 遵循 GitHub 发布；扩展可以自动检查更新。
稳定性 – 核心功能（execute_javascript、项目信息、资源检查、截图）标记为稳定。高级工具集（full 配置文件）可用，但可能会演变。
平台 – 仅编辑器；不会向最终游戏构建添加运行时代码。
支持的 Cocos Creator – 3.8+（已在 macOS、Linux、Windows 上测试）。

许可证

MIT – 免费用于商业和非商业用途，需注明出处。

底线 – Funplay MCP for Cocos 为你提供了一个即插即用的桥梁，连接现代 AI 编码助手和 Cocos Creator 编辑器，让 AI 通过一个单一、文档完善的 HTTP JSON‑RPC 服务器操作场景、资源和编辑器状态。

FunplayAI/funplay-cocos-mcp