Slaythespire Mcp
What is Slaythespire Mcp
slaythespire-mcp is a package designed for integrating external AI with the game Slay the Spire through the Communication Mod. It allows communication between the game and external processes, enabling advanced interactions and automation.
Use cases
Use cases for slaythespire-mcp include developing AI opponents that can play the game, creating tools for game analysis, and automating repetitive tasks within the game. It can also be used for testing game mechanics and enhancing user experience.
How to use
To use slaythespire-mcp, first install it by running ‘python setup.py install’. Then, configure the Communication Mod to run the MCP server using ‘python /path/to/spirecomm-mcp/main.py’ for production or ‘python mcp_server.py’ for standalone testing.
Key features
Key features include access to the complete game state, character information, current game status, and detailed screen information. It also provides tools for performing game actions such as playing cards, using potions, ending turns, and starting new games.
Where to use
slaythespire-mcp can be used in game development, AI research, and automation projects where interaction with Slay the Spire is required. It is particularly useful for developers looking to create AI agents or tools that enhance gameplay.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Slaythespire Mcp
slaythespire-mcp is a package designed for integrating external AI with the game Slay the Spire through the Communication Mod. It allows communication between the game and external processes, enabling advanced interactions and automation.
Use cases
Use cases for slaythespire-mcp include developing AI opponents that can play the game, creating tools for game analysis, and automating repetitive tasks within the game. It can also be used for testing game mechanics and enhancing user experience.
How to use
To use slaythespire-mcp, first install it by running ‘python setup.py install’. Then, configure the Communication Mod to run the MCP server using ‘python /path/to/spirecomm-mcp/main.py’ for production or ‘python mcp_server.py’ for standalone testing.
Key features
Key features include access to the complete game state, character information, current game status, and detailed screen information. It also provides tools for performing game actions such as playing cards, using potions, ending turns, and starting new games.
Where to use
slaythespire-mcp can be used in game development, AI research, and automation projects where interaction with Slay the Spire is required. It is particularly useful for developers looking to create AI agents or tools that enhance gameplay.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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 stategame://character- Character informationgame://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 handuse_potion- Use a potionend_turn- End the current turnproceed- Proceed to next screencancel- Cancel current actionchoose- Make a choicestart_game- Start a new game
Installing spirecomm:
Run python setup.py install from the distribution root directory
Testing Seed
YF62XIUSE56D
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
