zork-mcp

A text-adventure interpreter as an MCP server. The AI is the player — it explores, solves puzzles, fights trolls, and collects treasure, turn by turn, through tool calls.

Games

• colossal-dungeon — a Zork-style dungeon: a grue in the dark, a toll-collecting troll, a locked grate, five treasures.

• brainrot-manor — a meme palace. Collect the aura artifacts. Become the main character.

Related MCP server: DMCP

Tools

• list_games — available games

• start_game(gameId) — start/restart, returns your first room

• act(command) — look, go north, take the lantern, use lantern, attack troll with sword, inventory...

• hint — a nudge for the current room

• score — treasures, moves, win status

Run

npm install && npm run build && node dist/index.js

Example session

1. start_game("colossal-dungeon")

2. act("take the lantern") → act("use lantern")

3. act("go north") — a troll blocks you...

4. act("attack troll with sword")

5. ...find all 4 treasures to win

Add a game

Games are pure data — see src/games.ts. Rooms, items with use-effects, hints, and treasures are all declarative; no engine changes needed.