更新大量官方api工具，目前已支持超过150个工具调用，支持除了预制体操作之外的所有cocos 操作。同时mcp端口更健壮，ai使用起来准确率更高。修复大量bug
This commit is contained in:
root
44
README.zh-CN.md
Executable file → Normal file
44
README.zh-CN.md
Executable file → Normal file
@@ -4,12 +4,12 @@
|
||||
|
||||
一个适用于 Cocos Creator 3.8+ 的综合性 MCP（模型上下文协议）服务器插件，使 AI 助手能够通过标准化协议与 Cocos Creator 编辑器进行交互。一键安装和使用，省去所有繁琐环境和配置。已经测试过Claude客户端Claude CLI和Cursor，其他的编辑器理论上也完美支持。
|
||||
|
||||
**🚀 现在提供 9 个类别的 80 个工具，实现95%的编辑器控制！（暂时无法操控预制体）**
|
||||
**🚀 现在提供 13 个类别的 151 个工具，实现98%的编辑器控制！（预制体实例化存在子节点恢复问题）**
|
||||
|
||||
##快速链接
|
||||
|
||||
- **[📖 Complete Feature Guide (English)](FEATURE_GUIDE_EN.md)** - Detailed documentation for all 80 tools
|
||||
- **[📖 完整功能指南 (中文)](FEATURE_GUIDE_CN.md)** - 所有80个工具的详细文档
|
||||
- **[📖 Complete Feature Guide (English)](FEATURE_GUIDE_EN.md)** - Detailed documentation for all 151 tools（待补充）
|
||||
- **[📖 完整功能指南 (中文)](FEATURE_GUIDE_CN.md)** - 所有151工具的详细文档（待补充）
|
||||
|
||||
## 快速使用
|
||||
|
||||
@@ -107,6 +107,9 @@ claude mcp add --transport http http://localhost:3000/mcp（使用你自己配
|
||||
- **消息广播**: 监听和广播自定义消息
|
||||
- **资源管理**: 创建、复制、移动、删除和查询资源
|
||||
- **构建系统**: 项目构建和预览服务器控制
|
||||
- **参考图片管理**: 在场景视图中添加、删除和管理参考图片
|
||||
- **场景视图控制**: 控制Gizmo工具、坐标系和视图模式
|
||||
- **高级场景操作**: 撤销/重做、快照和高级节点操作
|
||||
|
||||
## 安装说明
|
||||
|
||||
@@ -152,7 +155,7 @@ npm run build
|
||||
|
||||
1. 从 `扩展 > Cocos MCP Server` 打开 MCP 服务器面板
|
||||
2. 配置设置：
|
||||
- **端口**: http 服务器端口（默认：3000）
|
||||
- **端口**: HTTP 服务器端口（默认：3000）
|
||||
- **自动启动**: 编辑器启动时自动启动服务器
|
||||
- **调试日志**: 启用详细日志以便开发调试
|
||||
- **最大连接数**: 允许的最大并发连接数
|
||||
@@ -161,7 +164,7 @@ npm run build
|
||||
|
||||
### 连接 AI 助手
|
||||
|
||||
服务器在 `http://localhost:3000/mcp`（或您配置的端口）上提供 http 端点。
|
||||
服务器在 `http://localhost:3000/mcp`（或您配置的端口）上提供 HTTP 端点。
|
||||
|
||||
AI 助手可以使用 MCP 协议连接并访问所有可用工具。
|
||||
|
||||
@@ -172,14 +175,17 @@ AI 助手可以使用 MCP 协议连接并访问所有可用工具。
|
||||
- **scene_\***: 场景相关操作 (8个工具)
|
||||
- **node_\***: 节点操作 (9个工具)
|
||||
- **component_\***: 组件管理 (7个工具)
|
||||
- **prefab_\***: 预制体操作 (8个工具)
|
||||
- **prefab_\***: 预制体操作 (11个工具)
|
||||
- **project_\***: 项目控制 (22个工具)
|
||||
- **debug_\***: 调试工具 (7个工具)
|
||||
- **preferences_\***: 编辑器偏好设置 (6个工具)
|
||||
- **server_\***: 服务器信息 (8个工具)
|
||||
- **debug_\***: 调试工具 (10个工具)
|
||||
- **preferences_\***: 编辑器偏好设置 (7个工具)
|
||||
- **server_\***: 服务器信息 (6个工具)
|
||||
- **broadcast_\***: 消息广播 (5个工具)
|
||||
- **assetAdvanced_\***: 高级资源操作 (10个工具)
|
||||
- **referenceImage_\***: 参考图片管理 (12个工具)
|
||||
- **sceneAdvanced_\***: 高级场景操作 (23个工具)
|
||||
- **sceneView_\***: 场景视图控制 (14个工具)
|
||||
|
||||
**总计: 80个工具** 实现全面的编辑器控制。
|
||||
|
||||
📖 **[查看完整工具文档](FEATURE_GUIDE_CN.md)** 了解详细的使用示例和参数。
|
||||
|
||||
@@ -262,7 +268,21 @@ cocos-mcp-server/
|
||||
│ ├── settings.ts # 设置管理
|
||||
│ ├── types/ # TypeScript 类型定义
|
||||
│ ├── tools/ # 工具实现
|
||||
│ └── panels/ # UI 面板实现
|
||||
│ │ ├── scene-tools.ts
|
||||
│ │ ├── node-tools.ts
|
||||
│ │ ├── component-tools.ts
|
||||
│ │ ├── prefab-tools.ts
|
||||
│ │ ├── project-tools.ts
|
||||
│ │ ├── debug-tools.ts
|
||||
│ │ ├── preferences-tools.ts
|
||||
│ │ ├── server-tools.ts
|
||||
│ │ ├── broadcast-tools.ts
|
||||
│ │ ├── scene-advanced-tools.ts
|
||||
│ │ ├── scene-view-tools.ts
|
||||
│ │ ├── reference-image-tools.ts
|
||||
│ │ └── asset-advanced-tools.ts
|
||||
│ ├── panels/ # UI 面板实现
|
||||
│ └── test/ # 测试文件
|
||||
├── dist/ # 编译后的 JavaScript 输出
|
||||
├── static/ # 静态资源（图标等）
|
||||
├── i18n/ # 国际化文件
|
||||
@@ -329,7 +349,7 @@ npm run build
|
||||
|
||||
## 系统要求
|
||||
|
||||
- Cocos Creator 3.8.0 或更高版本
|
||||
- Cocos Creator 3.8.6 或更高版本
|
||||
- Node.js（Cocos Creator 自带）
|
||||
- TypeScript（作为开发依赖安装）
|
||||
|
||||
|
||||
Reference in New Issue
Block a user