Game MCP

Multi-agent game development framework for Claude Code. Build games with an AI team — Lead, Engineer, Designer, Artist, QA, and Story Consultant.

Quick Start

npx game-mcp

The CLI will guide you through:

1. Game name and code

2. Game type — Web (HTML/JS), Unity 2D, or Unity 3D

3. API keys — Gemini, PixelLab, GitHub/GitLab (stored encrypted, gitignored)

4. Platform targets — PC, iOS, Android, Steam

5. Git provider — GitHub, GitLab, or local

Then open the project in Claude Code and type /lead to start.

Related MCP server: HiveClaude

Game Types

Web Game

• Single HTML file with inline CSS/JS

• Canvas API game loop

• Packageable for Steam via Electron

• No dependencies, pure vanilla JS

Unity 2D

• Unity 6 with URP 2D

• PixelLab MCP for AI pixel art generation

• Aseprite CLI for sprite post-processing

• VContainer DI + UniTask async

Unity 3D

• Unity 6 with URP 3D

• Blender MCP for 3D modeling

• PBR materials and lighting

• VContainer DI + UniTask async

How It Works

Game MCP uses a Bible-first approach: design your game completely in documentation before writing code.

Agent Roles

Task Flow

/lead → analyzes request → creates tasks with priorities
/engineer → claims task → implements → self-reviews → completes
/qa → verifies → 5-check gate → approves or reports bugs

Requirements

• Claude Code (CLI)

• Python 3.11+ + uv

• Git

• Node.js 18+ (for CLI and web games)

Optional (by game type)

API Keys (optional, enable AI features)

Project Structure (after setup)

my-game/
├── .claude/           # Claude Code config + agent commands
│   ├── CLAUDE.md      # Project instructions
│   ├── settings.json  # Permissions
│   └── commands/      # /lead, /engineer, /designer, /artist, /qa, /story
├── .mcp.json          # MCP server config
├── .env               # API keys (gitignored)
├── src/               # Game code (HTML or Unity scripts)
├── docs/bible/        # Game design document (13 sections)
├── workflow/           # Task management state
├── game-mcp.json      # Project config
└── pyproject.toml     # MCP server dependencies

MCP Server

The framework includes a Python MCP server (game-mcp-team) that provides:

• Task management — create, claim, complete, search tasks with priorities

• Decision log — cross-agent context sharing

• Bible status — documentation completeness tracking

• External tools — Gemini CLI, Aseprite CLI, background removal

License

MIT