经 AI Skill Hub 精选评估,Cocos Creator 3.8.x MCP工具 获评「推荐使用」。这款MCP工具在功能完整性、社区活跃度和易用性方面表现出色,AI 评分 7.5 分,适合有一定技术背景的用户使用。
Cocos Creator 3.8.x MCP工具 是一款遵循 MCP(Model Context Protocol)标准协议的 AI 工具扩展。通过 MCP 协议,它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务,实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用,都可以通过自然语言在 AI 对话中直接触发,极大提升生产效率。
Cocos Creator 3.8.x MCP工具 是一款遵循 MCP(Model Context Protocol)标准协议的 AI 工具扩展。通过 MCP 协议,它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务,实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用,都可以通过自然语言在 AI 对话中直接触发,极大提升生产效率。
# 方式一:通过 Claude Code CLI 一键安装
claude skill install https://github.com/HappyLifeOk/cc-3-8-x-mcp
# 方式二:手动配置 claude_desktop_config.json
{
"mcpServers": {
"cocos-creator-3-8-x-mcp--": {
"command": "npx",
"args": ["-y", "cc-3-8-x-mcp"]
}
}
}
# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
# 安装后在 Claude 对话中直接使用 # 示例: 用户: 请帮我用 Cocos Creator 3.8.x MCP工具 执行以下任务... Claude: [自动调用 Cocos Creator 3.8.x MCP工具 MCP 工具处理请求] # 查看可用工具列表 # 在 Claude 中输入:"列出所有可用的 MCP 工具"
// claude_desktop_config.json 配置示例
{
"mcpServers": {
"cocos_creator_3_8_x_mcp__": {
"command": "npx",
"args": ["-y", "cc-3-8-x-mcp"],
"env": {
// "API_KEY": "your-api-key-here"
}
}
}
}
// 保存后重启 Claude Desktop 生效
Cocos Creator 3.8.x 的 MCP 桥接扩展 + 离线 prefab 读写 CLI。
把编辑器的 scene/asset/preview/local 能力以 MCP 协议暴露给 Claude Code;同时提供无需编辑器运行的 offline prefab 编辑能力,支持节点增删克隆与 stub 节点属性覆写。
---
通过菜单「扩展 → Cocos MCP → 功能面板」打开,或在编辑器扩展面板停靠。
| 区块 | 内容 |
|---|---|
| MCP Server | 运行状态指示灯 / 端点地址 / tool 数量 / 请求计数;复制端点、复制 CLI 命令、重启 |
| 编辑器状态 | 当前分支 / HEAD / 预览地址和端口 / 编辑器 PID / Watcher 状态 / 最后更新时间 |
| 快捷动作 | 一键刷新(资源+场景+预览)/ 软重载场景 / 打开预览浏览器 / 截图 / 打开 .dev 目录 / 清理临时文件 / 手动输入路径重新导入 |
| Debug 注入 | 在预览页面执行任意 JS(eval_js),结果直接展示;自定义快捷按钮(配置见下方) |
| 同机 Worktree | 列出同机其他 worktree 及其预览端口,方便多开切换 |
| 命令日志 | 最近 30 条操作记录(时间 / 来源 / 命令) |
自定义 Debug 按钮:在项目根目录新建 .dev/cc-mcp-panel.json:
{ "buttons": [{ "label": "解锁签到", "code": "app.userMod.setUserValue(0,1)" }] }
---
每个 Cocos 编辑器实例启动时向 ~/.cocos-mcp/editors/<pid>.json 写入注册信息:
{
"pid": 12345,
"url": "http://127.0.0.1:7788/mcp",
"shortName": "forest",
"projectPath": "/path/to/project"
}
router 定期扫此目录,心跳超过 120s 的记录视为死亡自动剔除。tool 名以 <shortName>__ 为前缀隔离,同机多开不冲突。
---
| Tool | 说明 |
|---|---|
scene_query_node_tree | 查询当前场景节点树;传 uuid 查子树 |
scene_query_node | 查询单节点完整 dump(含所有组件属性) |
scene_set_property | 设置节点/组件属性(path 为 dump path,如 position、__comps__.0.string) |
scene_open_scene | 打开场景(传场景资源 uuid) |
scene_save_scene | 保存当前场景 |
scene_soft_reload | 软重载场景,不清编辑器状态 |
scene_execute_component_method | 调用指定节点的组件方法 |
修改 prefab 资源文件属性建议用prefab_edit(offline),scene_set_property只适用于运行时节点或需要编辑器上下文的情况。
| Tool | 说明 |
|---|---|
asset_query_assets | 按 glob pattern 列资源(如 db://assets/**/*.prefab) |
asset_query_info | 查资源详情(传 uuid 或 url) |
asset_query_url | 由 uuid 查资源 url |
asset_query_uuid | 由 url 查资源 uuid |
asset_refresh | 刷新资源(全量或指定路径) |
asset_reimport | 重新导入指定资源 |
asset_create | 创建新资源 |
asset_save | 保存资源内容 |
asset_delete | 删除资源 |
asset_move | 移动/重命名资源 |
| Tool | 说明 |
|---|---|
preview_query_url | 查询当前预览 URL |
preview_open_browser | 在系统浏览器打开预览 |
preview_refresh_browser | 刷新预览页面 |
preview_screenshot | 截图,返回图片路径 |
preview_eval_js | 在预览页面执行 JS,返回执行结果 |
preview_refresh_and_reload | 重新导入资源后刷新预览(offline 改完必须调此工具才能看到效果) |
| Tool | 说明 |
|---|---|
local_get_status | 获取编辑器本地状态(git branch、预览端口、PID 等) |
local_list_worktrees | 列出同机所有 worktree |
local_open_dev_dir | 在 Finder 中打开 .dev 目录 |
local_clean_dev_dir | 清理 .dev 临时文件 |
| Tool | 说明 |
|---|---|
prefab_query | 查询 prefab 节点树或单节点详情 |
prefab_edit | 声明式批量编辑 prefab,所有 op 成功后一次性落盘 |
prefab_batch | 从 JSON 文件读取 ops 后批量编辑 prefab |
完整 op 列表与配方见 doc/cli.md。
offline tools 的filePath和opsJsonPath必须为绝对路径;router 以 stdio 模式运行,cwd 不确定,相对路径有歧义。
---
在 Cocos Creator 编辑器进程内运行。启动时拉起 server/mcp-server.js(HTTP MCP server),并把自身信息写入 ~/.cocos-mcp/editors/<pid>.json(心跳注册)。
暴露的 tool 域:
| 域 | 职责 |
|---|---|
| scene | 查询/修改节点树,打开/保存/重载场景,调用组件方法 |
| asset-db | 资源查询、导入、创建、保存、删除、移动 |
| preview | 预览地址查询、浏览器控制、截图、JS 注入 |
| local | 本地状态、worktree 列表、.dev 目录管理 |
该项目提供了Cocos Creator 3.8.x的MCP服务和离线CLI,适合用于AI客户端的场景和资源管理
AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。
✅ Apache 2.0 — 宽松开源协议,可商用,需保留版权声明和 NOTICE 文件,含专利授权条款。
AI Skill Hub 点评:Cocos Creator 3.8.x MCP工具 的核心功能完整,质量良好。对于Claude Desktop / Claude Code 用户来说,这是一个值得纳入个人工具库的选择。建议先在非生产环境试用,再逐步推广。
| 原始名称 | cc-3-8-x-mcp |
| 原始描述 | 开源MCP工具:Cocos Creator 3.8.x 的 MCP 服务 + 离线 CLI:把编辑器的场景/资源/预览/构建/进程控制以 MCP 协议暴露给 AI 客户端,附带。⭐41 · JavaScript |
| Topics | mcpjavascript |
| GitHub | https://github.com/HappyLifeOk/cc-3-8-x-mcp |
| License | Apache-2.0 |
| 语言 | JavaScript |
收录时间:2026-06-13 · 更新时间:2026-06-16 · License:Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。
选择 Agent 类型,复制安装指令后粘贴到对应客户端