游戏开发AI助手扩展

一个为Cocos Creator设计的扩展,实现模型上下文协议(MCP)服务器,通过流式HTTP传输直接在引擎内连接AI助手,无需外部工具或复杂设置。提供16种工具集,包括场景检查、节点创建、资产管理和AI图像生成等功能,优化游戏开发工作流。

  • by RomaRogov
  • TypeScript
  • 本地部署
  • 30 星标
  • 更新于
在 GitHub 查看 RomaRogov/cocos-mcp

使用说明

由于转向代码模式,此存储库将不再受支持。 请尝试一下!

Cocos Creator MCP服务器

一个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 - ⚡ 先进的人工智能资产创建

📦 资产与项目管理 (5个工具)

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

🔧 高级操作 (2个工具)

  • execute_scene_code -在场景上下文中直接执行Types/JavaScript
  • operate_scripts_and_text -全面的文件操作(读、写、搜索、替换)

🎨 实验性人工智能图像生成

利用先进的人工智能功能改变您的资产创建工作流程:

多模态生成模式:

  • SVG/表情符号→ Image:将矢量图形或表情符号转换为游戏资源
  • Text → Image:根据描述性提示生成资产
  • SVG+文本→ Image:使用SVG作为AI增强的模板/init图像

提供商生态系统:

  • 自动1111:WebUI集成(已测试)
  • 稳定扩散:本地或远程安装(未经测试)
  • OpenAI DALL-E:基于云的生成(未经测试)
  • 自定义提供商:新服务的可扩展架构

高级功能:

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

AI优化工作流程:

  • 模板增强:使用现有资产作为生成模板
  • 提示工程:负面提示和引导比例控制
  • 资产一体化:生成的内容自动导入,并带有适当的元数据

快速开始

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

AI图像生成设置

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

快速启动局部稳定扩散

  1. 在Cocos Creator中打开AI图像生成配置面板
  2. 添加指向的新稳定扩散提供程序 http://localhost:7860
  3. 通过UI配置您的模型
  4. 测试连接

技术实现

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

建筑

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

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

开发环境

  • Node.js
  • TypeScript
  • 视图3.x
  • 用于HTTP服务器的Express.js
  • MCP TypeScript SDK

安装

# Install dependencies
npm install

# Build the extension
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许可证获得许可。