# Cocos MCP 下载与安装教程：Funplay MCP for Cocos 让 AI 直接操作 Cocos Creator
---

**关键词：** Cocos MCP、Cocos Creator MCP、Funplay MCP、Cocos AI开发、Cocos Creator AI、Cocos MCP下载、Cocos MCP安装、Codex Cocos、Cursor Cocos、Claude Cocos、AI游戏开发、Cocos Creator 3.8

大家好，这里是「代码简单说」。
![image](https://developer.qcloudimg.com/http-save/yehe-1530503/b818f2c37379646abe2503e45cf68555.png)


最近在使用 AI 辅助开发 Cocos Creator 游戏时，一个比较实用的方向就是通过 **MCP（Model Context Protocol）** 让 AI 编程助手直接连接 Cocos Creator 编辑器。

这次介绍的 **Funplay MCP for Cocos**，就是一个嵌入 Cocos Creator 编辑器的 MCP Server。安装之后，可以让 Claude Code、Cursor、Codex、VS Code Copilot、Trae、Kiro 等支持 MCP 的 AI 客户端直接检查和操作当前 Cocos 项目。

## 一、Cocos MCP 是什么？
![image](https://developer.qcloudimg.com/http-save/yehe-1530503/1958d48517f355534c3dbaa86376c6af.png)

Funplay MCP for Cocos 是一个基于 MIT 协议的 Cocos Creator 扩展。

它的核心思路是：

```text
AI 编程助手
    ↓
MCP
    ↓
Funplay MCP for Cocos
    ↓
Cocos Creator
    ↓
当前游戏项目
```

与需要额外运行独立服务的方案不同，这个项目直接将 HTTP MCP Server 嵌入 Cocos Creator 扩展中，不需要额外启动 Python 守护进程或者外部 Bridge。

项目目前面向 **Cocos Creator 3.8+**，并且属于 **Editor Only** 扩展，不会向最终游戏包增加运行时依赖。

---

## 二、Cocos MCP 下载地址

如果不想自己从 GitHub 获取安装包，可以直接使用我整理的下载地址。

| 项目           | 地址                                             |
| ------------ | ---------------------------------------------- |
| Cocos MCP 下载 | [夸克网盘下载](https://pan.quark.cn/s/4c88933c46a6)  |
| Cocos Store  | https://store.cocos.com/app/detail/8913        |
| GitHub 项目    | https://github.com/FunplayAI/funplay-cocos-mcp |

夸克网盘：

**https://pan.quark.cn/s/4c88933c46a6**

项目官方也支持从 Cocos Store 安装，或者从 GitHub Releases 下载扩展压缩包。

---

# 三、Cocos MCP 有什么作用？

安装之后，AI 不再只能通过修改项目文件来开发游戏，而是可以进一步获取 Cocos Creator 当前编辑器状态，并直接执行相关操作。

其中最核心的工具是：

```text
execute_javascript
```

它提供两个主要执行上下文：

```text
scene
editor
```

`scene` 用于当前场景以及运行态环境，`editor` 则用于 Cocos Creator 编辑器环境。

例如，你可以直接告诉 AI：

```text
在当前 Cocos 场景中创建一个登录页面，
包含账号输入框、密码输入框、登录按钮和游客登录按钮。
```

AI 可以调用 MCP 工具创建 UI，检查节点层级，并通过截图确认最终效果。

---

# 四、支持哪些 AI 编程工具？

Funplay MCP for Cocos 支持多个 MCP 客户端，包括：

```text
Claude Code
Claude Desktop
Cursor
Codex
VS Code
Trae
Kiro
```

项目提供了 Cocos Creator 内置的一键配置功能，可以直接选择目标客户端并完成 MCP 配置。

其中服务器名称统一使用：

```text
funplay_cocos
```

---

# 五、安装 Cocos MCP

## 1. 准备 Cocos Creator

首先安装 Cocos Creator。

这个 MCP 项目面向 **Cocos Creator 3.8+**。

如果你目前正在使用 Cocos Creator 3.8.x，可以直接按照下面的步骤进行安装。

---

## 2. 下载 MCP

下载地址：

**https://pan.quark.cn/s/4c88933c46a6**

下载完成后解压安装包。

如果使用 GitHub Releases，则项目提供：

```text
Funplay.CocosMcp.v<version>.zip
```

解压之后得到：

```text
funplay-cocos-mcp
```

目录。

---

# 六、安装到 Cocos Creator 项目

进入你的 Cocos Creator 项目目录。

例如：

```text
D:\CocosProjects\MyGame
```

在项目根目录创建：

```text
extensions
```

目录。

最终结构类似：

```text
MyGame
├─ assets
├─ extensions
│  └─ funplay-cocos-mcp
├─ settings
├─ library
└─ project.json
```

官方也提供 Git 安装方式：

```bash
cd /path/to/your-cocos-project
mkdir -p extensions
git clone https://github.com/FunplayAI/funplay-cocos-mcp.git extensions/funplay-cocos-mcp
```

然后重新启动 Cocos Creator，或者重新加载扩展。

---

# 七、给所有 Cocos 项目安装

这个项目还提供了一个比较方便的功能，可以将扩展安装到当前 Creator 版本的全局扩展目录。

进入：

```text
Funplay > MCP Settings
```

然后在“所有项目”区域点击：

```text
为所有项目安装
```

程序会下载最新 GitHub Release，并校验：

```text
SHA256SUMS.txt
```

然后安装到 Cocos Creator 当前版本的全局扩展目录。

Windows 默认位置：

```text
%USERPROFILE%\.CocosCreator\builtin-extensions\<Creator 版本>\funplay-cocos-mcp
```

macOS / Linux：

```text
~/.CocosCreator/builtin-extensions/<Creator 版本>/funplay-cocos-mcp
```

需要注意的是，Cocos Creator 的全局扩展是按照版本隔离的。

例如同时使用：

```text
Cocos Creator 3.8.5
Cocos Creator 3.8.8
```

那么两个版本需要分别执行一次全局安装。

---

# 八、启动 Cocos MCP Server

安装完成以后，在 Cocos Creator 顶部菜单找到：

```text
Funplay > MCP Server
```

打开 MCP Server 面板。

默认服务地址：

```text
http://127.0.0.1:8765/
```

正常情况下启动后，AI 客户端只需要连接这个本地地址即可。

---

# 九、配置 AI 客户端

## 方法一：一键配置

推荐直接使用：

```text
Funplay > MCP Server
```

然后找到：

```text
MCP Client Config
```

选择需要使用的 AI 客户端，然后点击：

```text
One-Click Configure
```

扩展会直接写入推荐 MCP 配置。

这种方法最方便，也不需要自己寻找各种配置文件。

---

# 十、手动配置 Codex

如果你使用的是 Codex，可以手动编辑 MCP 配置。

Codex 配置：

```toml
[mcp_servers.funplay_cocos]
url = "http://127.0.0.1:8765/"
```

项目官方 README 也提供了对应的 Codex 配置格式。

配置完成后重新启动 Codex。

---

# 十一、手动配置 Cursor

Cursor 可以使用：

```json
{
  "mcpServers": {
    "funplay_cocos": {
      "url": "http://127.0.0.1:8765/"
    }
  }
}
```

---

# 十二、手动配置 Claude Code / Claude Desktop

配置示例：

```json
{
  "mcpServers": {
    "funplay_cocos": {
      "type": "http",
      "url": "http://127.0.0.1:8765/"
    }
  }
}
```

---

# 十三、手动配置 VS Code

VS Code 使用：

```json
{
  "servers": {
    "funplay_cocos": {
      "type": "http",
      "url": "http://127.0.0.1:8765/"
    }
  }
}
```

---

# 十四、验证 MCP 是否连接成功

完成配置之后，可以让 AI 执行一些简单的查询。

例如：

```text
调用 get_project_info，告诉我当前 Cocos 项目信息。
```

或者：

```text
读取 cocos://project/context，
告诉我当前 Cocos Creator 编辑器状态。
```

也可以测试：

```text
使用 execute_javascript 的 scene 上下文，
返回当前场景名称。
```

以及：

```text
使用 execute_javascript 的 editor 上下文，
返回当前项目路径。
```

这些测试正常返回，就说明 MCP Server 已经与 AI 客户端连接。

---

# 十五、使用 curl 检查 MCP Server

如果 AI 客户端没有连接成功，可以直接通过命令行检查服务。

执行：

```bash
curl http://127.0.0.1:8765/health
```

以及：

```bash
curl http://127.0.0.1:8765/tools
```

项目提供了这两个只读接口，方便在不连接 MCP 客户端的情况下检查本地服务是否正常。

如果 `/health` 能正常返回，通常说明 Cocos Creator 内部的 MCP Server 已经成功启动。

---

# 十六、Cocos MCP 支持哪些能力？

这个项目目前功能比较完整。

在 `full` profile 下，一共提供：

```text
105 个工具
```

主要可以分成以下几个类别：

| 类型     | 主要能力                                  |
| ------ | ------------------------------------- |
| 脚本执行   | JavaScript、Scene Script、Editor Script |
| 编辑器    | 编辑器状态、选择、工具目录                         |
| 项目     | 项目信息、项目指令                             |
| 场景     | 创建、打开、检查、层级管理                         |
| 节点     | 创建、删除、Transform 修改                    |
| Prefab | 检查、创建、复制、实例化、应用                       |
| 组件     | 添加、删除、属性修改                            |
| UI     | Canvas、Label、Button、Sprite            |
| 相机     | 相机创建和参数修改                             |
| 动画     | Animation Clip、播放、停止                  |
| 文件     | 读取、写入、替换、搜索                           |
| 日志     | 日志查询、搜索、清理                            |
| 构建     | Build 状态、预览、构建面板                      |
| 运行态    | 暂停、恢复、时间缩放                            |
| 输入     | 鼠标、键盘、按钮事件                            |
| 截图     | 编辑器、场景、Game、Preview                   |

---

# 十七、默认 core 模式与 full 模式

项目并不是默认一次把全部 105 个工具都开放给 AI。

默认使用：

```text
core
```

模式。

默认：

```text
39 个高频工具
```

如果需要全部能力，可以切换：

```text
full
```

这样就会暴露：

```text
105 个工具
```

另外还有：

```text
custom
```

模式，可以按照分类或者具体工具进行自定义。

对于普通 Cocos 开发项目，推荐先使用：

```text
core
```

这样可以减少 AI 的工具列表噪音。

需要高级自动化功能时，再切换：

```text
full
```

---

# 十八、AI 可以直接操作 Cocos 场景

安装 MCP 之后，一个比较直观的使用方式就是让 AI 直接处理当前场景。

例如：

```text
在当前 Cocos 场景里创建一个登录页面。

要求：
1. 创建 Canvas
2. 添加背景
3. 添加账号输入框
4. 添加密码输入框
5. 添加登录按钮
6. 添加游客登录按钮
7. 检查节点层级
8. 截图验证最终效果
```

AI 可以调用：

```text
execute_javascript
```

以及场景、节点、UI、截图等工具完成操作。

项目本身也将：

```text
execute_javascript
```

作为核心主工具。

---

# 十九、MCP 还可以读取 Cocos 项目上下文

项目提供了多个 MCP Resources。

例如：

```text
cocos://project/context
cocos://project/summary
cocos://scene/active
cocos://scene/current
cocos://selection/current
cocos://selection/asset
cocos://errors/scripts
cocos://logs/editor
cocos://logs/project
cocos://mcp/interactions
```

这意味着 AI 不只是执行命令，还可以读取当前 Cocos 项目的上下文。

对于 AI 编程而言，这一点非常重要。

例如在排查问题的时候，可以让 AI：

```text
读取当前项目脚本诊断信息，
分析目前有哪些 TypeScript 错误。
```

或者：

```text
查看当前场景层级，
分析为什么这个 UI 没有正常显示。
```

---

# 二十、截图与视觉验证

项目还支持截图相关能力，包括：

```text
capture_desktop_screenshot
capture_editor_screenshot
capture_scene_screenshot
capture_game_screenshot
capture_preview_screenshot
```

这样 AI 在完成场景或者 UI 修改之后，可以进一步进行视觉验证。

例如：

```text
创建完成后截图检查 UI 是否正确。
如果按钮位置异常，自动调整。
```

这对于 AI 开发 UI、游戏原型尤其有价值。

---

# 二十一、Cocos MCP 安全机制

由于 MCP 可以让 AI 直接操作开发环境，所以安全问题也比较重要。

项目的 `execute_javascript` 默认启用了安全检查，会拦截部分明显的高风险操作，例如：

```text
删除 / 截断操作
原始写入流
路径穿越
用户或系统绝对路径
child_process
```

因此这个项目并不是一个完全不受限制的脚本执行环境。

不过项目也明确说明，这属于防护栏，并不是完整意义上的沙箱。

---

# 二十二、项目文件访问范围

文件工具以及：

```text
cocos://asset/path/...
```

资源默认只能访问：

```text
当前 Cocos 项目根目录
```

内部文件。

因此实际使用时，建议把需要 AI 修改的代码、资源和配置都放在项目目录内部。

---

# 二十三、可选配置文件

如果需要自定义 MCP，可以在 Cocos 项目根目录创建：

```text
funplay-cocos-mcp.config.json
```

例如：

```json
{
  "host": "127.0.0.1",
  "port": 8765,
  "toolProfile": "core",
  "enabledToolCategories": [],
  "disabledToolCategories": [],
  "enabledTools": [],
  "disabledTools": [],
  "enableSessions": false,
  "executeJavascriptSafetyChecks": true,
  "autostart": true,
  "maxInteractionLogEntries": 50,
  "activeToolProfileName": "",
  "savedToolProfiles": []
}
```

还支持：

```text
COCOS_MCP_HOST
COCOS_MCP_PORT
COCOS_MCP_PROFILE
```

环境变量。

---

# 二十四、浏览器预览模式

对于 Cocos Creator 3.8.x，项目还支持预览自动化。

目前包括：

| 模式          | 作用                         |
| ----------- | -------------------------- |
| `browser`   | 使用系统浏览器打开场景                |
| `gameView`  | 使用 Cocos Creator Game View |
| `simulator` | 使用原生模拟器                    |

可以通过：

```text
get_preview_mode
```

获取当前预览模式。

通过：

```text
set_preview_mode
```

切换模式。

通过：

```text
run_project_preview
```

启动项目预览。

---

# 二十五、安装完成后的推荐工作流

实际使用时，可以采用下面的流程：

```text
Cocos Creator
     ↓
打开项目
     ↓
启动 Funplay MCP
     ↓
AI 客户端连接 MCP
     ↓
读取项目上下文
     ↓
读取当前场景
     ↓
执行代码或工具
     ↓
截图验证
     ↓
继续修改
```

推荐优先使用：

```text
execute_javascript
```

然后结合：

```text
场景检查
资产检查
脚本诊断
截图
运行态控制
```

完成完整开发流程。项目官方也推荐以 `execute_javascript` 为主要工作方式，再结合截图、诊断、资产和检查类工具。

---

# 二十六、常见问题

## 1. MCP Server 没有启动怎么办？

首先确认 Cocos Creator 中是否存在：

```text
Funplay > MCP Server
```

然后检查：

```text
http://127.0.0.1:8765/health
```

如果端口被占用，项目会检查已有 listener 是否属于同一个 Cocos 项目；如果不是，才会自动切换到其他可用本地端口。

---

## 2. 修改端口后需要重启吗？

项目支持在 MCP Settings 中修改端口，并会自动保存配置，需要时自动重启服务。

---

## 3. 为什么 AI 看不到全部工具？

项目默认使用：

```text
core
```

模式。

这个模式默认开放 39 个高频工具。

如果需要全部工具，可以将 profile 调整为：

```text
full
```

完整模式提供 105 个工具。

---

## 4. 多个 Cocos Creator 版本怎么办？

全局扩展按照 Creator 版本隔离。

因此如果使用多个 Creator 版本，需要在各个版本中分别执行：

```text
为所有项目安装
```

---

# 二十七、总结

对于使用 AI 开发 Cocos 游戏的人来说，Funplay MCP for Cocos 的核心价值在于：

```text
AI
+
MCP
+
Cocos Creator
```

真正连接起来。

它不仅可以读取项目文件，还可以直接访问 Cocos Creator 当前编辑器状态、场景、Prefab、组件、资源、日志、预览状态，并通过 JavaScript、场景工具、截图和输入模拟等能力完成自动化操作。

核心能力可以概括为：

```text
Cocos Creator 3.8+
        ↓
Funplay MCP for Cocos
        ↓
HTTP MCP Server
        ↓
Codex / Cursor / Claude / Trae / Kiro / VS Code
        ↓
AI 辅助开发 Cocos 游戏
```

对于想尝试 **AI + Cocos Creator** 开发模式的开发者，可以先安装体验。

### Cocos MCP 下载地址

[夸克网盘下载：https://pan.quark.cn/s/4c88933c46a6](https://pan.quark.cn/s/4c88933c46a6)





关键词： Cocos MCP、Cocos Creator MCP、Funplay MCP、Cocos AI开发、Cocos Creator AI、Cocos MCP下载、Cocos MCP安装、Codex Cocos、Cursor Cocos、Claude Cocos、AI游戏开发、Cocos Creator 3.8

Cocos MCP 下载与安装教程：Funplay MCP for Cocos 让 AI 直接操作 Cocos Creator

开发工具

人工智能

FunplayMCP for Cocos让AI编程助手直接操控Cocos Creator编辑器。支持Claude、Cursor、Codex等工具，提供105项能力：场景操作、UI创建、脚本执行、截图验证。内置安全机制，仅限项目目录访问。下载安装后，AI即可读取上下文并自动完成游戏开发任务。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Cocos MCP 下载与安装教程：Funplay MCP for Cocos 让 AI 直接操作 Cocos Creator-腾讯云开发者社区-腾讯云

Cocos MCP 下载与安装教程：Funplay MCP for Cocos 让 AI 直接操作 Cocos Creator

Cocos MCP 下载与安装教程：Funplay MCP for Cocos 让 AI 直接操作 Cocos Creator

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐