role-playing

This MCP server powers an immersive role-playing experience. It provides seven core tools to manage RPG games: createGame to initialize a new adventure with characters, world state, and inventory; updateGame to apply state changes (including nested paths) and trigger a Game Over flow when conditions are met; getGame to fetch the current complete game state; progressStory to advance the narrative and log situational context; promptUserActions to present dynamic, risk-reward action options (2-4 choices with positive and negative outcomes) and render a web-based UI; selectAction to apply the chosen action and record history; and selectRestart to restart after a game over, including AI-assisted context for a fresh adventures. The system includes a Delta display for real-time changes, automatic game history of the last ten situations and choices, and an empathetic Game Over UI with guidance for improvement. You can interact through the web UI or via MCP-enabled clients such as Claude Desktop, MCP-UI compatible tools, or other MCP-UI clients. The flow generally follows createGame → progressStory → promptUserActions → selectAction → updateGame → progressStory → … with a dedicated restart path after game over.

Prerequisites:

• Node.js 18.x or newer
• npm 9.x or newer
• Internet access to fetch the MCP package

Installation steps (recommended):

1. Install the MCP server package globally so you can run it from anywhere:

npm install -g rpg-mcp-server

2. Start the server locally for development/testing:

rpg-mcp-server

3. Alternatively, run with npx (without global install):

npx -y rpg-mcp-server

4. If you want to test integration with Claude Desktop or MCP-UI clients, ensure the client is configured to the server endpoint (default localhost/port as defined by the package) and that the MCP protocol version is compatible (SDK 0.5.0+).

5. Optional: build or run in development mode if provided by the project (check repository for specific build steps):

git clone <repository-url>
cd rpg-mcp-server
npm install
npm run build
npm start

Notes and tips:

• The server exposes delta-style change tracking for real-time feedback on state updates. Use getGame to inspect the full state at any time.
• When an update sets isGameOver to true, a Game Over UI is shown with a description and suggested improvements. Restart via selectRestart to generate a fresh context for a new adventure.
• The promptUserActions tool always generates 2-4 dynamic choices with mixed risk/reward to keep gameplay engaging.
• You can customize environment variables for different deployment environments (e.g., NODE_ENV, API keys) via the mcp_config env block. Ensure sensitive values are securely managed in production.
• The last ten game situations and corresponding user choices are automatically stored for reference and replayability.