使用说明
由于转向代码模式,此存储库将不再受支持。 请尝试一下!
Cocos Creator MCP服务器
一个Cocos Creator扩展,它实现了一个具有流式HTTP传输的模型上下文协议(MCP)服务器。此扩展运行 直接在Cocos Creator中 -无需外部工具、桥接器或设置。只需安装扩展程序,即可开始将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/JavaScriptoperate_scripts_and_text-全面的文件操作(读、写、搜索、替换)
🎨 实验性人工智能图像生成
利用先进的人工智能功能改变您的资产创建工作流程:
多模态生成模式:
- SVG/表情符号→ Image:将矢量图形或表情符号转换为游戏资源
- Text → Image:根据描述性提示生成资产
- SVG+文本→ Image:使用SVG作为AI增强的模板/init图像
提供商生态系统:
- 自动1111:WebUI集成(已测试)
- 稳定扩散:本地或远程安装(未经测试)
- OpenAI DALL-E:基于云的生成(未经测试)
- 自定义提供商:新服务的可扩展架构
高级功能:
- 动态模型选择:从配置的提供程序自动填充
- 背景移除:精灵/图标的自动透明度
- 资产类型控制:生成纹理、精灵帧、法线贴图等。
- 重复的结果:基于种子的一致性生成
- 批量操作:高效的批量资产创建
AI优化工作流程:
- 模板增强:使用现有资产作为生成模板
- 提示工程:负面提示和引导比例控制
- 资产一体化:生成的内容自动导入,并带有适当的元数据
快速开始
- 安装并启用:在Cocos Creator中安装扩展,并在扩展管理器中启用它
- 启动服务器:打开
Panel -> cocos-mcp -> MCP Server Control Panel然后单击“开始” - 连接AI:将您的AI助手指向
http://localhost:3000/mcp - 开始创建:使用自然语言构建游戏、生成资产并快速迭代
AI图像生成设置
- 配置提供程序:使用扩展的AI图像生成配置面板
- 添加模型:通过UI为每个提供程序配置可用模型
- 测试连接性:使用内置测试功能验证提供程序设置
- 生成资产:使用
generate_image_assetMCP工具
快速启动局部稳定扩散
- 在Cocos Creator中打开AI图像生成配置面板
- 添加指向的新稳定扩散提供程序
http://localhost:7860 - 通过UI配置您的模型
- 测试连接
技术实现
- 运输:使用Express.js服务器进行流式HTTP传输
- 协议:JSON-RPC 2.0符合正确的错误处理
- 会话管理:支持CORS的状态连接
- 类型安全:使用Zod模式进行输入验证的完整TypeScript实现
- 模块化架构:每个资源、工具和完成都在单独的文件中实现
建筑
该扩展由几个关键组件组成:
- 扩展面板 (
source/panels/default/):用于控制MCP服务器的基于Vue3的UI - MCP服务器管理器 (
source/mcp/server-manager.ts):管理HTTP服务器和MCP传输 - 工具 (
source/mcp/tools/):提供修改项目的操作
开发环境
- Node.js
- TypeScript
- 视图3.x
- 用于HTTP服务器的Express.js
- MCP TypeScript SDK
安装
# Install dependencies
npm install
# Build the extension
npm run build
发展
添加新工具
- 在中创建新文件
source/mcp/tools/ - 实施使用
server.registerTool()使用Zod模式 - 出口登记功能
- 添加导入和调用
server-manager.ts
依赖项
@modelcontextprotocol/sdk-MCP TypeScript SDKexpress-HTTP服务器框架zod-架构验证vue-面板的UI框架
许可证
该项目根据MIT许可证获得许可。
