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.

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.