Game Asset Generator using MCP and Hugging Face Spaces

Game Asset Generator using MCP and Hugging Face Spaces

site icon
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_TOKENMODEL_SPACE
  • ES模块错误:确保使用Node.js 16+版本。

使用教程

使用依赖

  • Node.js:版本16+(包含npm)。
  • Git:用于克隆仓库。
  • 互联网访问:需要Hugging Face API连接。
  • Hugging Face账户:获取API令牌。

安装教程

  1. 克隆仓库bash git clone https://github.com/yourusername/game-asset-mcp.git cd game-asset-mcp
  2. 安装依赖bash npm install
  3. 配置环境
  4. 复制示例.env文件: bash cp .env.example .env
  5. 编辑.env文件,填入Hugging Face API令牌和复制的MODEL_SPACE

调试方式

  • 本地运行(stdio传输)bash npm start
  • 远程运行(SSE传输)bash node src/index.js --sse
  • 查看日志bash tail -f ./logs/server.log

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。