zork mcp

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 byturn, through tool calls.

Games

• colossal dungeon, a Zork style dungeon: a grue in the dark, atoll collecting troll, a locked grate, five treasures.
• brainrot manor, a meme palace. Collect the aura artifacts. Becomethe 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.