项目简介

Game Asset Generator MCP Server 是一个基于 Model Context Protocol (MCP) 的应用后端，它利用 Hugging Face 上的 AI 模型，根据用户提供的文本提示，自动生成 2D 和 3D 游戏素材。您可以将此服务器与支持 MCP 协议的客户端（如 Claude Desktop）连接，从而方便地在 AI 助手中使用游戏素材生成功能。

主要功能点

2D 素材生成: 通过文本提示，快速生成像素艺术、精灵图等 2D 游戏素材。
3D 素材生成: 通过文本提示，生成 3D 模型 (OBJ/GLB 格式)，支持从图像到模型的自动转换。
MCP 协议集成: 无缝对接 MCP 客户端，例如 Claude Desktop，实现便捷的 AI 助手交互体验。
本地文件管理: 自动保存和组织生成的素材到本地文件系统，方便项目集成和访问。
资源模板: 支持使用动态 URI (例如 'asset://{type}/{id}') 过滤和访问素材，高效管理资源。
多客户端支持: 通过 SSE 传输协议，支持多客户端同时连接。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js (版本 16 或更高)。

克隆仓库: 使用 Git 克隆仓库到本地：

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

安装依赖: 在仓库目录下运行以下命令安装项目依赖：
```
npm install
```

配置 Hugging Face API Token:

复制 '.env.example' 文件并重命名为 '.env'。
打开 '.env' 文件，填入您的 Hugging Face API Token。您可以在 huggingface.co/settings/tokens 获取。

HF_TOKEN=your_hf_token

如果您使用了 Gradio 的用户名和密码，也可以在 '.env' 文件中配置：

GRADIO_USERNAME=your_username  # 可选
GRADIO_PASSWORD=your_password  # 可选

服务器配置

为了使 MCP 客户端（如 Claude Desktop）能够连接到此服务器，您需要在客户端中配置服务器信息。以下是 Claude Desktop 的配置示例，您需要编辑 'claude_desktop_config.json' 文件（macOS: '~/Library/Application Support/Claude/claude_desktop_config.json', Windows: '%APPDATA%\Claude\claude_desktop_config.json'），并添加如下 'mcpServers' 配置：

{
  "mcpServers": {
    "game-asset-generator": {  // 服务器名称，在 Claude Desktop 中显示的名称
      "command": "node",      // 启动服务器的命令
      "args": [                // 启动服务器命令的参数
        "/path/to/game-asset-mcp/index.js" //  index.js 文件的完整路径，请替换为您的实际路径
      ]
    }
  }
}

注意: 请将 '/path/to/game-asset-mcp/index.js' 替换为您本地仓库 'index.js' 文件的实际完整路径。配置完成后，重启 Claude Desktop 即可。

可选的服务器启动参数:

指定工作目录: 'node index.js /path/to/your/directory' 启动服务器并指定素材保存的工作目录。
启用 SSE 传输: 'node index.js --sse' 启用 SSE 传输模式，用于远程客户端连接。
启用 HTTPS (SSE 传输模式下): 'node index.js --sse --https' 启用 HTTPS 加密 SSE 传输，需要 SSL 证书 (ssl/key.pem 和 ssl/cert.pem)。

基本使用方法

服务器成功启动并与 MCP 客户端连接后，您可以使用以下工具生成游戏素材：

生成 2D 素材: 在 MCP 客户端中输入命令 'generate_2d_asset prompt:"素材描述"'，例如 'generate_2d_asset prompt:"像素风宝剑"'，服务器将根据提示生成 2D 素材并保存到本地，同时返回文件路径资源链接。
生成 3D 素材: 在 MCP 客户端中输入命令 'generate_3d_asset prompt:"素材描述"'，例如 'generate_3d_asset prompt:"等距视角城堡"'，服务器将根据提示生成 3D 模型 (OBJ/GLB 格式) 并保存到本地，同样会返回文件路径资源链接。

生成的素材默认保存在服务器工作目录下的 'assets' 文件夹中。您可以通过 MCP 客户端提供的资源管理功能 (如果支持) 访问和使用这些素材。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息