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.

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

Command	Role	What They Do
/lead	Team Lead	Research, plan, create tasks
/engineer	Engineer	Write game code
/designer	Designer	Write game design docs
/artist	Artist	Generate and process art assets
/qa	QA	5-check verification of all changes
/story	Story	Narrative structure consulting

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)

Tool	Web	Unity 2D	Unity 3D
Unity 6		Required	Required
Blender			Required
Aseprite		Recommended
Gemini CLI	Recommended	Recommended	Recommended

API Keys (optional, enable AI features)

Key	Purpose	Get it at
GOOGLE_API_KEY	Gemini research + image gen	Google AI Studio
PIXELLAB_API_TOKEN	AI pixel art (2D)	PixelLab
RODIN_API_KEY	AI 3D models (3D)	Rodin
GIT_TOKEN	GitHub/GitLab integration	GitHub/GitLab settings

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