Cocos Creator MCP Server

一个Cocos Creator扩展，实现了具有可流式传输HTTP传输的模型上下文协议（MCP）服务器。此扩展直接在Cocos Creator中运行——无需外部工具、桥梁或设置。只需安装扩展并开始将AI助手连接到您的游戏开发工作流程。

仅使用此扩展通过AI代理提示创建的游戏示例

主要优势

🚀 零配置集成

• 引擎内运行：MCP服务器直接在Cocos Creator扩展中运行
• 可流式传输HTTP传输：通过http://localhost:3000/mcp直接连接
• 无外部依赖：无需额外工具、桥梁或复杂设置
• 即时访问：从内置控制面板一键启动服务器

🎯 紧凑而全面的工具集

精心策划的16个强大工具集合，旨在实现最大AI效率：

🔍 发现与检查（5个工具）

• query_nodes - 使用细粒度控制检查场景层次结构
• query_components - 发现组件属性及其类型和工具提示
• get_available_asset_types - 列举所有可用资产类型
• get_available_component_types - 列举所有可用组件类型
• get_assets_by_type - 按特定类型查询资产

🏗️ 创建与修改（4个工具）

• create_nodes - 批量节点创建，包括组件和变换
• modify_nodes - 批量属性更新、层次结构更改、组件管理
• modify_components - 使用UUID目标进行精确组件配置
• generate_image_asset - ⚡ 高级AI驱动的资产创建

📦 资产与项目管理（5个工具）

• operate_assets - 全面的资产操作（创建、复制、移动、删除、检查）
• operate_current_scene - 场景生命周期管理（打开、保存、配置）
• operate_prefab_assets - 完整的预制件工作流（创建、编辑、关闭）
• node_linked_prefabs_operations - 预制件实例管理（编辑、展开、重置）
• operate_project_settings - 项目配置（层、碰撞、设计分辨率）

🔧 高级操作（2个工具）

• execute_scene_code - 在场景上下文中直接执行TypeScript/JavaScript
• operate_scripts_and_text - 全面的文件操作（读取、写入、搜索、替换）

🎨 实验性AI图像生成

利用高级AI能力转变您的资产创建工作流程：

多模态生成模式：

• SVG/Emoji → 图像：将矢量图形或表情符号转换为游戏资产
• 文本 → 图像：根据描述性提示生成资产
• SVG + 文本 → 图像：使用SVG作为模板/初始图像进行AI增强

提供商生态系统：

• AUTOMATIC1111：WebUI集成（已测试）
• Stable Diffusion：本地或远程安装（未测试）
• OpenAI DALL-E：基于云的生成（未测试）
• 自定义提供商：可扩展架构以支持新服务

高级功能：

• 动态模型选择：自动填充已配置的提供商
• 背景移除：自动透明度用于精灵/图标
• 资产类型控制：生成为纹理、精灵帧、法线贴图等
• 可重复结果：基于种子的生成以确保一致性
• 批量操作：高效的批量资产创建

AI优化的工作流程：

• 模板增强：使用现有资产作为生成模板
• 提示工程：负面提示和指导比例控制
• 资产整合：生成的内容自动导入并带有正确的元数据

快速入门

1. 安装并启用：在Cocos Creator中安装扩展，并在扩展管理器中启用它
2. 启动服务器：打开面板 -> cocos-mcp -> MCP服务器控制面板并点击启动
3. 连接AI：将您的AI助手指向http://localhost:3000/mcp
4. 开始创建：使用自然语言构建游戏、生成资产并快速迭代

AI图像生成设置

1. 配置提供商：使用扩展的AI图像生成配置面板
2. 添加模型：通过UI为每个提供商配置可用模型
3. 测试连接：使用内置测试功能验证提供商设置
4. 生成资产：使用generate_image_asset MCP工具

使用本地Stable Diffusion快速入门

1. 在Cocos Creator中打开AI图像生成配置面板
2. 添加一个新的Stable Diffusion提供商，指向http://localhost:7860
3. 通过UI配置您的模型
4. 测试连接

技术实现

• 传输：使用Express.js服务器的可流式传输HTTP传输
• 协议：符合JSON-RPC 2.0规范并具备适当的错误处理
• 会话管理：支持CORS的状态连接
• 类型安全：使用Zod模式进行输入验证的全TypeScript实现
• 模块化架构：每个资源、工具和完成都在单独的文件中实现

架构

该扩展由几个关键组件组成：

1. 扩展面板（source/panels/default/）：基于Vue3的UI，用于控制MCP服务器
2. MCP服务器管理器（source/mcp/server-manager.ts）：管理HTTP服务器和MCP传输
3. 工具（source/mcp/tools/）：提供修改项目的动作

开发环境

• Node.js
• TypeScript
• Vue 3.x
• 使用Express.js的HTTP服务器
• MCP TypeScript SDK

安装

# 安装依赖
npm install

# 构建扩展
npm run build

开发

添加新工具

1. 在source/mcp/tools/中创建新文件
2. 使用server.registerTool()和Zod模式实现
3. 导出注册函数
4. 在server-manager.ts中添加导入并调用

依赖项

• @modelcontextprotocol/sdk - MCP TypeScript SDK
• express - HTTP服务器框架
• zod - 模式验证
• vue - 面板的UI框架

许可证

本项目采用MIT许可证。 </中文翻译>