Game Asset Generator with AI and MCP Integration

Overview

The Game Asset Generator is an innovative tool that simplifies game asset creation by leveraging AI-powered generation. It integrates AI models from Hugging Face Spaces and uses the Model Context Protocol (MCP) for seamless interaction with AI assistants like Claude Desktop. This tool enables users to create 2D and 3D game assets from text prompts effortlessly.

Features

• 2D Asset Generation: Create pixel art, sprites, or other 2D assets from text prompts.
• 3D Asset Generation: Generate 3D models (OBJ and GLB formats) from text descriptions.
• Multiple 3D Model Spaces: Supports InstantMesh, Hunyuan3D-2, and Hunyuan3D-2mini-Turbo.
• MCP Integration: Seamlessly interact with the tool via MCP-compatible clients like Claude Desktop.
• File Management: Automatically saves and organizes assets in a local assets directory.
• Robust Input Validation: Uses Zod for secure and reliable input processing.
• Multi-Client Support: Handles multiple simultaneous connections via SSE transport.
• Secure Remote Access: Optional HTTPS support for safe remote communication.
• Extensible Backend: Modular design for easy integration of new models or features.
• Cross-Platform: Compatible with Windows, macOS, and Linux using Node.js.

How It Works

1. User Input: Submit a text prompt (e.g., "pixel art sword" or "isometric 3D castle").
2. MCP Server: Routes the prompt to the appropriate tool (generate_2d_asset or generate_3d_asset).
3. AI Model Interaction:
4. 2D Assets: Utilizes the Hugging Face Inference API with "gokaygokay/Flux-2D-Game-Assets-LoRA".
5. 3D Assets: Generates an initial image and converts it to a 3D model using one of the supported spaces.
6. File Output: Saves assets in the assets directory.
7. Response: Returns resource URIs for immediate use.

Prerequisites

• Node.js: Version 16+.
• Git: For cloning the repository.
• Internet Access: Required for Hugging Face API connectivity.
• Hugging Face Account: Needed for API access.
• NPM Packages: @gradio/client, @huggingface/inference, @modelcontextprotocol/sdk, dotenv, express, zod, sharp.

Installation

1. Clone the Repository:
   shell git clone https://github.com/yourusername/game-asset-mcp.git cd game-asset-mcp
2. Install Dependencies:
   shell npm install
3. Configure Environment:
   shell cp .env.example .env
4. Run the Server:
   shell npm start

Usage

Interact with the server via an MCP client (e.g., Claude Desktop) or programmatically:
- Generate a 2D Asset:
shell generate_2d_asset prompt:"pixel art sword"
- Generate a 3D Asset:
shell generate_3d_asset prompt:"isometric 3D castle"

Configuration

Customize the server via the .env file:
- HF_TOKEN: Hugging Face API token.
- MODEL_SPACE: Your duplicated 3D model space.

File Management

• Storage Location: Assets are saved in ./assets within the working directory.
• Naming Convention: Files use a prefix, tool name, timestamp, and unique ID.

MCP Integration

The Model Context Protocol (MCP) enables this tool to serve AI clients securely:
- Tools: generate_2d_asset, generate_3d_asset.
- Resources: Managed via asset:// URIs.
- Compatibility: Works with Claude Desktop and other MCP clients.

Troubleshooting

• API Errors: Check network connectivity or rate limits.
• Authentication Issues: Verify HF_TOKEN and MODEL_SPACE in .env.
• Logs: Inspect detailed logs:
  shell tail -f ./logs/server.log

Advanced

API Endpoints and Integration

• 2D Asset Generation: Uses "gokaygokay/Flux-2D-Game-Assets-LoRA".
• 3D Asset Image Generation: Uses "gokaygokay/Flux-Game-Assets-LoRA-v2".
• 3D Model Conversion: Supports InstantMesh, Hunyuan3D-2, and Hunyuan3D-2mini-Turbo.

Versioning

• Current Version: 0.3.0.
• MCP SDK Version: 1.7.0.

Contributing

We welcome contributions! To participate:
1. Fork the Repository.
2. Make Changes.
3. Submit a Pull Request.
4. Open Issues.

License

Licensed under the MIT License. See the LICENSE file for details.