Game Asset Generator MCP server for AI agents

The Game Asset Generator is an MCP server that allows you to create 2D and 3D game assets using AI models from Hugging Face Spaces. It enables game developers to rapidly generate pixel art, sprites, and 3D models from text prompts through a simple interface.

Installation

Prerequisites

Node.js (version 16+)
Git
Internet connection
Hugging Face account with API token

Setup Instructions

Clone the repository and install dependencies:

git clone https://github.com/yourusername/game-asset-mcp.git
cd game-asset-mcp
npm install

Create environment configuration:
```
cp .env.example .env
```
Configure your environment variables: Edit the .env file and add:
```
HF_TOKEN=your_huggingface_token
MODEL_SPACE=your-username/InstantMesh
```
Note: For 3D model generation, you must duplicate one of these Hugging Face spaces to your account:
Start the server:
```
npm start
```

Usage

Basic Commands

The server supports two main commands:

Generate 2D assets:

generate_2d_asset prompt:"pixel art sword"

Generate 3D assets:

generate_3d_asset prompt:"isometric 3D castle"

Integration with Claude Desktop

To use with Claude Desktop:

Edit Claude's configuration file:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the server configuration:

{
  "mcpServers": {
    "game-asset-generator": {
      "command": "node",
      "args": ["/full/path/to/game-asset-mcp/src/index.js"]
    }
  }
}

Restart Claude Desktop
Type commands directly in Claude's interface

Configuration Options

Required Settings

HF_TOKEN: Your Hugging Face API token
MODEL_SPACE: Your duplicated 3D model space (e.g., your-username/InstantMesh)

Optional 3D Model Settings

Variable	Description	Valid Range/Default
`MODEL_3D_STEPS`	Inference steps	Varies by space
`MODEL_3D_GUIDANCE_SCALE`	Prompt following strength	0.0-100.0 (default: 5.0-5.5)
`MODEL_3D_OCTREE_RESOLUTION`	3D model detail level	Varies by space
`MODEL_3D_SEED`	Randomness control	0-10000000
`MODEL_3D_REMOVE_BACKGROUND`	Remove image background	`true`/`false` (default: `true`)
`MODEL_3D_TURBO_MODE`	Generation speed (Hunyuan3D-2mini-Turbo only)	`Turbo`, `Fast`, `Standard`

Transport Settings

PORT: Server port for SSE transport (default: 3000)

Advanced Server Options

Custom working directory:
```
node src/index.js /path/to/directory
```
Enable SSE transport (for remote connections):
```
node src/index.js --sse
```
Enable HTTPS (requires SSL certificates):
```
node src/index.js --sse --https
```

Troubleshooting

API Errors: Check your network connection or API rate limits
Authentication Issues: Verify your HF_TOKEN and MODEL_SPACE in .env
ES Modules Error: Ensure you're using Node.js 16+ (node --version)
Check logs for detailed error information:
```
tail -f ./logs/server.log
```

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "game-asset-generator" '{"command":"node","args":["/full/path/to/game-asset-mcp/src/index.js"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "game-asset-generator": {
            "command": "node",
            "args": [
                "/full/path/to/game-asset-mcp/src/index.js"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "game-asset-generator": {
            "command": "node",
            "args": [
                "/full/path/to/game-asset-mcp/src/index.js"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect