STS2 MCP —— AI 自動プレイ設定ガイド
STS2 MCP mod を導入し、Claude や任意の MCP エージェントを接続して『スレイ・ザ・スパイア 2』を全自動でプレイ。
Mod v0.3.4 · STS2 v0.103.2 で動作確認 · MIT ライセンス · Windows / macOS / LinuxSTS2 MCP とは?
STS2 MCP は、『スレイ・ザ・スパイア 2』のゲーム状態と操作を localhost の REST API 経由で公開し、さらに任意の MCP サーバーを備えたコミュニティ mod です。AI エージェントを接続すれば、モデルが盤面を読み取り自力でランを完走できます——STS2 のランを完全自動化する実験的プロジェクトです。
- シングルプレイと協力(co-op)の両方を全自動化。メニュー、ロビー、キャラクター選択まで対応
- localhost:15526 の HTTP でリアルタイムにゲーム状態を取得
- プロファイル進捗、コンペンディウム、解放済みカード/レリックのあいまい wiki 検索
- Claude Code、Claude Desktop、または任意のカスタム MCP クライアントに対応
必要環境
『スレイ・ザ・スパイア 2』本体(v0.103.2 で動作確認)
Python 3.11+ と uv パッケージマネージャ(MCP サーバーのみ必要)
Claude Code、Claude Desktop、または MCP 対応の他クライアント
ステップ 1 —— Mod の導入
Mod は DLL 1 つとマニフェストだけ。両方をゲームの mods フォルダに入れれば、HTTP サーバーが自動で起動します。
- 1
GitHub リポジトリから最新リリースをダウンロード。
- 2
STS2_MCP.dll と STS2_MCP.json を [ゲームインストール先]/mods/ にコピー。ダウンロード
- 3
ゲームを起動し、設定で mods を有効化。
- 4
HTTP サーバーが localhost:15526 で自動起動します。
macOS のインストールパス
macOS では mods フォルダは app bundle 内にあります。次のコマンドで作成し、ファイルをコピーします。
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/"インストールの確認
ゲーム起動中にルートエンドポイントへアクセス。正常ならバージョン入りの挨拶が返ります。
curl -s http://localhost:15526/{"message": "Hello from STS2 MCP v0.3.4", "status": "ok"}ステップ 2 —— AI を接続
任意の MCP サーバーにより、Claude がツール呼び出しで mod と通信できます。Python 3.11+ と uv が必要です。
このブロックを Claude Code の .mcp.json または Claude Desktop の claude_desktop_config.json に追加し、directory をローカルのチェックアウト先に向けてください。
{
"mcpServers": {
"sts2": {
"command": "uv",
"args": ["run", "--directory", "/path/to/STS2MCP/mcp", "python", "server.py"]
}
}
}任意フラグ
- --host と --port:既定以外のアドレスで実行。
- --no-trust-env:プロキシ環境変数を無視。
API & MCP ツールリファレンス
独自エージェントを作る場合、これらが mod の公開インターフェイスです。REST エンドポイントは直接アクセス可能、MCP サーバーはそれらをツールとしてラップします。
REST エンドポイント
GET /api/v1/profileアクティブなプロファイルの永続的な進捗サマリー。GET /api/v1/compendium高レベルの進捗:カードライブラリ、レリック、ポーション、ベスティアリー、キャラ統計、ラン履歴。GET /api/v1/wiki?query=...解放済みカードとレリックのあいまい検索(既定 10 件、limit で上書き可)。GET /api/v1/profiles3 つのプロファイルスロットとアクティブなものを一覧表示。POST /api/v1/profilesプロファイルスロットの切り替えまたは削除。MCP サーバーツール
get_game_state()現在のゲーム状態。get_profile()アクティブなプロファイルデータ。get_compendium()メインメニューまたは進行中のランからの永続コンテキスト。search_wiki(query, item_type, limit)カードまたはレリックの個別検索。list_profiles()プロファイルスロットの一覧。switch_profile(profile_id)アクティブなプロファイルを切り替え。delete_profile(profile_id)プロファイルスロットを削除。トークンコスト
全自動プレイはトークンを大量に消費します:Claude Sonnet 4.6 でアイアンクラッド(Ironclad)を 1 ラン完走すると約 800 万トークン(入力・出力・ツール応答の合計)、GPT-5.4 では約 734 万。エージェントに昇天を周回させる前に、API 予算を計画しておきましょう。
STS2 MCP は Gennadiyev によるオープンソースプロジェクトで、MIT ライセンスで公開されています。リリース、ソース、issue はリポジトリを参照してください。
GitHub で見る