
Game Asset Generator using MCP and Hugging Face Spaces

2025.03.23
44
JavaScript游戏资产生成AI生成工具内容生成娱乐功能
Game Asset Generator 是一个创新的工具,利用AI技术简化游戏资产的创建过程。它支持通过文本提示生成2D和3D游戏资产,集成了Hugging Face Spaces的AI模型和Model Context Protocol (MCP),适用于游戏开发者和AI爱好者。
View on GitHub
Overview
基本能力
产品定位
Game Asset Generator 是一个AI驱动的游戏资产生成工具,旨在简化游戏开发中的资产创建过程。
核心功能
- 2D资产生成:从文本提示生成像素艺术、精灵等2D资产。
- 3D资产生成:生成OBJ和GLB格式的3D模型,支持自动图像到模型的转换。
- 多3D模型空间支持:支持InstantMesh、Hunyuan3D-2和Hunyuan3D-2mini-Turbo等多种3D生成工作流。
- MCP集成:通过MCP兼容客户端(如Claude Desktop)无缝交互。
- 文件管理:自动保存和组织资产到本地目录。
- 多客户端支持:通过SSE传输处理多个同时连接。
- 安全远程访问:支持HTTPS安全远程通信。
适用场景
- 游戏开发快速原型设计
- AI爱好者探索生成模型
- 需要快速生成游戏资产的开发者
工具列表
generate_2d_asset
:生成2D游戏资产generate_3d_asset
:生成3D游戏资产
常见问题解答
- API错误:检查网络连接或速率限制,查看
./logs/server.log
。 - 认证问题:验证
.env
文件中的HF_TOKEN
和MODEL_SPACE
。 - ES模块错误:确保使用Node.js 16+版本。
使用教程
使用依赖
- Node.js:版本16+(包含
npm
)。 - Git:用于克隆仓库。
- 互联网访问:需要Hugging Face API连接。
- Hugging Face账户:获取API令牌。
安装教程
- 克隆仓库:
bash git clone https://github.com/yourusername/game-asset-mcp.git cd game-asset-mcp
- 安装依赖:
bash npm install
- 配置环境:
- 复制示例
.env
文件:bash cp .env.example .env
- 编辑
.env
文件,填入Hugging Face API令牌和复制的MODEL_SPACE
。
调试方式
- 本地运行(stdio传输):
bash npm start
- 远程运行(SSE传输):
bash node src/index.js --sse
- 查看日志:
bash tail -f ./logs/server.log