ツール

STS2 MCP —— AI 自動プレイ設定ガイド

STS2 MCP mod を導入し、Claude や任意の MCP エージェントを接続して『スレイ・ザ・スパイア 2』を全自動でプレイ。

Mod v0.3.4 · STS2 v0.103.2 で動作確認 · MIT ライセンス · Windows / macOS / Linux

STS2 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. 1

    GitHub リポジトリから最新リリースをダウンロード。

  2. 2

    STS2_MCP.dll と STS2_MCP.json を [ゲームインストール先]/mods/ にコピー。ダウンロード

  3. 3

    ゲームを起動し、設定で mods を有効化。

  4. 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"]
    }
  }
}
macOS では command フィールドに uv の絶対パス(例:/opt/homebrew/bin/uv)を指定してください。さもないと Claude が見つけられないことがあります。

任意フラグ

  • --host と --port:既定以外のアドレスで実行。
  • --no-trust-env:プロキシ環境変数を無視。
設定を編集したら Claude を再起動し、get_game_state を実行させて接続を確認します。

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 で見る