Game Forge — Educational Game MCP

Builds single-file browser games that teach one concept through play. The design doctrine lives in prompts/system_prompt.md — edit it, restart, done.

Run

pip install -r requirements.txt
python app.py

• MCP endpoint: http://127.0.0.1:8000/mcp

• Health: http://127.0.0.1:8000/health

• Saved games: http://127.0.0.1:8000/games/<name>.html

Related MCP server: cognitive-tools-mcp / gikendaasowin-aabajichiganan

MCP surface

Generate a game

game.py ties the MCP to a local Ollama model (gemma4:12b):

# Terminal 1: MCP server (still required)
python app.py

# Terminal 2: generate a game
python game.py                              # prompts for topic
python game.py "equivalent fractions"       # one-shot
python game.py --topic gravity --audience "ages 10-12" --session 10
python game.py "photosynthesis" --checklist # + auto self-fix pass

Prints the playable URL on success. Requires app.py to be running and Ollama to have gemma4:12b pulled.

Test it

python test_client.py        # exercises every MCP tool + the web endpoints

MCP Inspector (visual testing)

Option A — stdio (Inspector spawns the server itself):

npx @modelcontextprotocol/inspector python server.py

Option B — HTTP (Inspector connects to your running app; preferred here because it tests the real deployment surface, including /games/ hosting):

python app.py                                   # terminal 1
npx @modelcontextprotocol/inspector             # terminal 2, no args
# In the Inspector UI: Transport = "Streamable HTTP", URL = http://127.0.0.1:8000/mcp

Agent workflow (what an LLM client does)

1. build_game_prompt("photosynthesis") → system prompt for the game-brief

2. LLM generates the single-file HTML game from that prompt

3. save_game("photosynthesis", html) → /games/photosynthesis.html

4. review_checklist() → self-verify, fix, re-save