gennadiyev/sts2mcp

Slay the Spire 2のランを完全に自動化するための実験的な研究プロジェクト

Slay the Spire 2のAIエージェントがゲームをプレイできるMODです。ローカルホストのREST APIを通じてゲームの状態とアクションを公開し、オプションでClaude Desktop/Claude Code統合用のMCPサーバーも利用できます。

シングルプレイヤーおよびマルチプレイヤー(協力プレイ)に対応しており、メニューとロビーの全操作も可能です。プロフィール切り替え、キャラクター選択(SPおよびマルチマルチホスト/クライアント、オプションのシード)、マルチプレイヤーホスト/Steamフレンド参加/FastMPローカルホスト参加、マルチプレイヤーロードロビー(保存済み協力プレイ再開)、ゲームオーバー終了、FTUE/チュートリアルポップアップ処理、タイムラインの表示。STS2 v0.103.2でテスト済み。

[!警告] このMODは外部プログラムがlocalhost APIを通じてゲームを読み込み制御できるようにします。あまり気にしないランは自己責任で使用してください。

[!注意] マルチプレイヤーサポートはベータ中です。バグは覚悟してください。このMODをインストールした際に発生するマルチプレイの問題は、ゲーム自体ではなくMOD自体が原因である可能性が非常に高いです。STS2開発者にバグを報告する前に、MODを無効にして問題が解決しないか確認してください。

プレイヤーズのために

1.MODをインストールしてください

最新リリースを手に入れて、手順に従ってください:

An Experimental Research Project to Fully-Automate your Slay the Spire 2 Runs

A mod for Slay the Spire 2 that lets AI agents play the game. Exposes game state and actions via a localhost REST API, with an optional MCP server for Claude Desktop / Claude Code integration.

Singleplayer and multiplayer (co-op) supported, plus full menu and lobby control: profile switching, character select (SP and MP host/client) with optional seed, multiplayer host / Steam-friend join / FastMP localhost join, multiplayer load lobby for resuming saved co-op runs, game-over dismissal, FTUE/tutorial popup handling, and Timeline visibility. Tested against STS2 v0.103.2.

[!warning] This mod allows external programs to read and control your game via a localhost API. Use at your own risk with runs you care less about.

[!caution] Multiplayer support is in beta — expect bugs. Any multiplayer issues encountered with this mod installed are very likely caused by the mod, not the game. Please disable the mod and verify the issue persists before reporting bugs to the STS2 developers.

For Players

1. Install the Mod

Grab the latest release and follow the instructions:

1. Copy STS2_MCP.dll and STS2_MCP.json to /mods/
2. Launch the game and enable mods in settings (a consent dialog appears on first launch)
3. The mod starts an HTTP server on localhost:15526 automatically

[!note] The release DLL is a platform-agnostic .NET assembly — the same STS2_MCP.dll and STS2_MCP.json work on Windows, Linux, and macOS. No separate builds are needed.

macOS install

On macOS, the mods directory lives inside the app bundle. The default Steam install path is:

~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/
    SlayTheSpire2.app/Contents/MacOS/mods/

To install, right-click SlayTheSpire2.app → Show Package Contents, navigate to Contents/MacOS/, and create a mods folder. Or from the terminal:

GAME_DIR="$HOME/Library/Application Support/Steam/steamapps/common/Slay the Spire 2"
MODS_DIR="$GAME_DIR/SlayTheSpire2.app/Contents/MacOS/mods"
mkdir -p "$MODS_DIR"
cp STS2_MCP.dll "$MODS_DIR/"
cp STS2_MCP.json "$MODS_DIR/"

Launch the game and open Settings → Mods. The mod should appear in the list. A consent dialog appears on first launch — accept it to enable mod loading. Once enabled, verify the HTTP server is running:

curl -s http://localhost:15526/

A successful response looks like:

{"message": "Hello from STS2 MCP v0.3.4", "status": "ok"}

If you get “Connection refused”, the mod is not loaded — check that mods are enabled in the game’s settings.

2. Give Your AI Instructions to Interact with the Game