安装 cocos-mcp-server 需要手动将插件文件放到你的 Cocos Creator 项目里，并完成构建。整个流程并不复杂，跟着下面的步骤来就行。

📥 第一步：获取插件文件

首先，你需要把插件的源代码放到你的电脑上。推荐直接从它的 GitHub 仓库克隆：

1. 打开你的命令行工具（终端或 CMD）。

2. 定位到你的 Cocos Creator 项目目录。假设你的项目叫 MyGame，路径是 C:\Projects\MyGame。

3. 运行以下命令，将插件克隆到项目的 extensions 文件夹下：

   git clone https://github.com/DaxianLee/cocos-mcp-server.git "C:\Projects\MyGame\extensions\cocos-mcp-server"

⚠️ 重要提醒：首次安装或升级前，请先删除项目 settings/ 目录下的 mcp-server.json 和 tool-manager.json 两个文件，否则插件的工具列表可能显示异常。

🛠️ 第二步：安装依赖并构建

插件源码需要编译成 Cocos Creator 能识别的格式。这一步需要在插件目录下进行。

1. 在命令行中，进入插件目录：

   cd "C:\Projects\MyGame\extensions\cocos-mcp-server"

2. 安装所需的 npm 依赖包：

3. 执行构建命令，将 TypeScript 源码编译为 JavaScript：

▶️ 第三步：在 Cocos Creator 中启用插件

构建成功后，回到 Cocos Creator 编辑器：

1. 如果编辑器已打开，重启 Cocos Creator 或点击菜单栏的 扩展 -> 扩展管理器，点击“刷新”按钮，让编辑器识别新插件。

2. 刷新成功后，你会在顶部菜单栏看到 扩展 -> Cocos MCP Server 的选项，点击它打开控制面板。

3. 在面板中，点击 “启动服务器” 按钮。看到状态变为“运行中”或类似提示，就说明 MCP Server 启动成功了，默认地址是 http://127.0.0.1:3000/mcp。

🔗 第四步：连接到 Claude Code

最后，在终端里运行之前那条熟悉的命令，把 Claude Code 连接到刚启动的 MCP Server 上：

claude mcp add --transport http cocos-creator http://127.0.0.1:3000/mcp