slaythespire-mcp

# spirecomm A package for using Communication Mod with Slay the Spire, with MCP server for external AI integration ## Communication Mod Communication Mod is a mod that allows communication between Slay the Spire and an external process. It can be found here: https://github.com/ForgottenArbiter/CommunicationMod The spirecomm package facilitates communicating with Slay the Spire through Communication Mod and accessing the state of the game. ## Requirements: - Python 3.5+ ## Running the MCP Server: ### With Slay the Spire (Production) Configure Communication Mod to run: `python /path/to/spirecomm-mcp/main.py` ### Standalone Testing (Development) For testing without the game: `python mcp_server.py` The MCP server exposes: - Game state as resources: - `game://state` - Complete game state - `game://character` - Character information - `game://status` - Current game status (in_game, screen type, errors) - `game://screen` - Detailed current screen information - Game actions as tools: - `play_card` - Play a card from hand - `use_potion` - Use a potion - `end_turn` - End the current turn - `proceed` - Proceed to next screen - `cancel` - Cancel current action - `choose` - Make a choice - `start_game` - Start a new game ## Installing spirecomm: Run `python setup.py install` from the distribution root directory ## Testing Seed YF62XIUSE56D