MCP-TRPG-Game

MCP-TRPG-Game Server is an MCP-powered TRPG (tabletop role-playing game) server that leverages Large Language Models to act as an intelligent Keeper (KP). It exposes a suite of MCP tools that let the AI Keeper manage characters, scenarios, dice rolls, scene descriptions, and events, enabling AI-driven adventures and automated game management. The server supports both standard MCP stdio communication and an HTTP mode for integration with MCP clients.

Prerequisites:

• Install the .NET 10.0 SDK
  • https://dotnet.microsoft.com/download/dotnet/10.0
• Optional MCP-Compatible AI clients for enhanced integration
  • Cursor, Claude Desktop, VS Code with MCP extensions, etc.

Step-by-step installation:

1. Ensure the repository is cloned and dependencies are restored (for the .NET project):

2. Build the project:

# If you are upgrading from an older state, you may need to clean up or delete trpg.db as noted in docs
# Example: delete ./trpg.db if required

dotnet build

3. Run the MCP-enabled TRPG server in stdio mode (as MCP client integration):

dotnet run --project src/ToolBox/ToolBox.csproj --stdio

4. (Optional) Run in HTTP mode to expose an HTTP endpoint for MCP clients:

dotnet run --project src/ToolBox/ToolBox.csproj

5. By default the server uses SQLite and stores data in trpg.db; the database will be auto-created on first run.

6. API testing: you can experiment with the provided MCP HTTP endpoint or sample requests via MCP-enabled clients.

Tips:

• The MCP toolset includes 30+ tools for core game management, dice checks, and AI Keeper assistance. Use the MPC protocol to orchestrate scenes, character management, and random events.
• Default database is SQLite (trpg.db); ensure proper backups for production usage.
• If you encounter issues with the stdio integration, verify the MCP client configuration from the README examples to ensure the correct JSON structure for your editor or tool.
• For HTTP mode, the MCP endpoint is typically at http://localhost:5000/mcp; you can adjust depending on your deployment.
• When testing, you can start a new adventure with the StartTrpgAdventure tool and rely on the KP to guide the session using other tools.