README.md

---
title: Dream Game Forge
emoji: 🎮
colorFrom: purple
colorTo: blue
sdk: gradio
sdk_version: 5.42.0
app_file: app.py
pinned: false
tags:
  - mcp-in-action-track-creative
license: mit
---

**Created by [@jolyonbrown](https://huggingface.co/jolyonbrown)**

# 🎮 Dream Game Forge

**Discover your dream game by analyzing your Steam library, then play a personalized HTML5 prototype — all powered by autonomous AI agents.**

Built for the [MCP 1st Birthday Hackathon](https://huggingface.co/MCP-1st-Birthday) - Track: MCP in Action (Creative)

## How It Works

Dream Game Forge is an autonomous agentic system that:

1. **Investigates** - Takes your Steam ID and fetches your complete game library with playtime data via the Steam Web API
2. **Analyzes** - Uses Claude to identify patterns in what you play vs. what you buy and ignore, building a taste profile
3. **Identifies the Gap** - Determines what game *should* exist for you but doesn't, based on your unique gaming DNA
4. **Designs** - Creates a mini Game Design Document with core loop, mechanics, and emotional hooks
5. **Builds** - Generates a playable HTML5 Canvas prototype tailored to your gaming preferences

## Architecture

- **Agentic Workflow**: Claude operates autonomously with planning, reasoning, and tool execution
- **Dual MCP Servers**:
  - Custom Steam MCP server (fetches library data)
  - IGDB MCP server (enriches with game metadata)
- **Multi-Turn Collaboration**: Human-in-the-loop workflow with preference gathering
- **Context Engineering**: System prompts guide Claude to analyze gaming patterns and generate creative solutions
- **HTML5 Generation**: Self-contained games with no external dependencies, playable instantly in browser

## Tech Stack

- **Frontend**: Gradio (custom Blocks interface with multi-turn chat)
- **Agent**: Anthropic Claude Sonnet 4.5 with tool calling
- **MCP Servers**:
  - Custom Steam Web API MCP server
  - IGDB MCP server (via uvx)
- **Game Generation**: HTML5 Canvas with Web Audio API
- **Deployment**: HuggingFace Spaces

## Demo

🎥 **Demo Video**: https://www.kapwing.com/videos/692cd48553e3badedef19b5c

📱 **Social Post**: https://x.com/Eddie_Catflap/status/1995182071128498401

## Usage

1. Enter your Steam ID (17-digit number)
2. Click "Generate My Dream Game"
3. Watch the agent analyze your library
4. Play your personalized game prototype!

## Example Output

The agent generates unique games based on your profile:
- **PUBG + Skyrim player** → Exploration/survival hybrid with territorial mechanics
- **SimplePlanes + Portal 2 player** → Physics-based contraption puzzle builder

Every game is different, tailored to fill the gap in each player's gaming experience.

---

Built with Claude Code | MCP 1st Birthday Hackathon 2025