STARWARCLOUD STARWAR.AI
返回市场
<中文翻译> cocos-MCP服务器

<中文翻译> cocos-MCP服务器

作者：RomaRogov14 星标更新：2025-09-03
安装使用来源：spider==github.com

项目介绍

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许可证。 </中文翻译>