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