mcp-server-if

# mcp-server-if An MCP (Model Context Protocol) server for playing interactive fiction games. Enables AI assistants like Claude to play text adventure games through a standardized interface. ## Features - Play Glulx (.ulx, .gblorb) and Z-machine (.z3-.z8, .zblorb) games - Automatic game state persistence (save/restore between sessions) - Download games directly from the IF Archive - Optional journaling mode for reflective playthroughs - Works with Claude Desktop, Claude Code, and other MCP clients - Bundled interpreters (glulxe for Glulx, bocfel for Z-machine) ## Installation ```bash # Using uvx (recommended) uvx mcp-server-if # Or install with pip pip install mcp-server-if ``` The package includes pre-compiled interpreters. No additional setup required. ## Configuration ### Environment Variables | Variable | Description | Default | |----------|-------------|---------| | `IF_GAMES_DIR` | Directory to store games | `~/.mcp-server-if/games` | | `IF_GLULXE_PATH` | Override path to glulxe binary | Bundled binary | | `IF_BOCFEL_PATH` | Override path to bocfel binary | Bundled binary | | `IF_REQUIRE_JOURNAL` | Require journal reflections | `false` | ### Command Line Arguments ```bash mcp-server-if --help Options: --games-dir PATH Directory to store games --glulxe-path PATH Path to glulxe binary (overrides bundled) --require-journal Require journal reflections between turns ``` ## Usage with Claude Desktop Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `%APPDATA%\Claude\claude_desktop_config.json` on Windows): ```json { "mcpServers": { "interactive-fiction": { "command": "uvx", "args": ["mcp-server-if"] } } } ``` ## Usage with Claude Code ```bash claude mcp add interactive-fiction -- uvx mcp-server-if ``` ## Available Tools ### `play_if` Play a turn of interactive fiction. ``` play_if(game="zork", command="go north") play_if(game="zork…