项目简介

MCP游戏资产生成器是一个基于Model Context Protocol (MCP) 构建的服务器，旨在简化游戏开发中各种资产的创建过程。它通过整合OpenAI DALL-E、Google Gemini、FAL.ai等领先的AI模型，提供强大的图像、3D模型生成及编辑能力，并计划支持视频和音频生成，助力开发者快速产出高质量的游戏素材。

主要功能点

图像生成与编辑: 利用OpenAI DALL-E、Google Gemini和FAL.ai等模型，根据文本描述生成高质量图像，或对现有图像进行编辑。支持透明背景功能，非常适合生成游戏精灵图和UI元素。
角色资产生成: 快速创建角色立绘、角色变体和像素艺术角色，支持特定像素尺寸和透明背景，满足2D游戏和精灵图需求。
3D资产生成: 从图像或文本描述生成3D模型，支持多种3D生成模型（如Hunyuan3D、Trellis、Hunyuan World），并支持自动生成参考图像，方便3D艺术家使用。
纹理生成: 创建无缝贴图和各种材质类型（如漫反射、法线、粗糙度、置换贴图），支持透明背景，适用于3D环境和游戏道具。
物体参考图生成: 为3D建模目的，生成物体多视角（如正、侧、背、顶）参考图，为3D建模提供精确的视觉参考。
异步任务处理: 针对耗时较长的3D模型生成任务，提供异步处理机制并通过状态文件实时跟踪进度，避免MCP客户端超时。

安装步骤

克隆仓库: 打开终端或命令提示符，执行以下命令：

git clone https://github.com/Flux159/mcp-game-asset-gen
cd mcp-game-asset-gen

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

MCP客户端需要以下配置信息来连接MCP游戏资产生成器。您需要替换'OPENAI_API_KEY'、'GEMINI_API_KEY'和'FAL_AI_API_KEY'为您的实际API密钥。

{
  "name": "mcp-asset-gen",
  "command": "node",
  "args": [
    "dist/index.js"
  ],
  "env": {
    "OPENAI_API_KEY": "你的OpenAI API Key",
    "GEMINI_API_KEY": "你的Google Gemini API Key",
    "FAL_AI_API_KEY": "你的FAL.ai API Key",
    "ALLOWED_TOOLS": "可选，用逗号分隔你想启用的工具名称，例如：openai_generate_image,generate_texture。如果此变量留空，则所有工具都可用。"
  }
}

基本使用方法

配置好MCP客户端并启动MCP游戏资产生成器后，你可以通过LLM客户端（如Google Gemini、ChatGPT等）调用其暴露的工具和Prompt来生成游戏资产。以下是一些示例：

生成图像: 让LLM客户端调用 'openai_generate_image' 工具来生成一张图片。您需要提供'prompt' (图像描述) 和 'outputPath' (图像保存路径)。例如，告诉LLM：“请使用OpenAI生成一张图片，内容是‘一只戴着骑士盔甲的卡通猫，纯白背景’，保存到'./assets/cat_knight.png'。”
生成3D模型: 让LLM客户端调用 'image_to_3d_async' 工具。由于3D生成耗时，该工具会立即返回一个状态文件路径，您可以通过读取该文件来跟踪任务进度。例如，告诉LLM：“请使用FAL.ai的Hunyuan3D模型，从描述‘一把带有魔法符文的幻想风格剑’生成一个3D模型，保存到'./assets/magic_sword.glb'。”
生成角色立绘: 让LLM客户端调用 'generate_character_sheet' 工具。例如，告诉LLM：“请生成一个角色立绘，描述是‘一位穿着未来科技盔甲的女战士’，风格为‘赛博朋克动漫’，并包含多种表情和姿势，保存到'./assets/cyber_warrior_sheet.png'。”
使用Prompt模板: 让LLM客户端使用 'asset_generation' Prompt模板，并指定'asset_type' (如 ''image'' 或 ''3d'') 和 'style' (如 ''anime'' 或 ''realistic'')。LLM会根据此模板和您的具体需求，自动构造并调用合适的工具来生成资产。例如，告诉LLM：“我想生成一个‘图像’类型的游戏资产，风格是‘复古像素艺术’。”

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息