工具

STS2 MCP —— AI 自動遊玩設定教學

安裝 STS2 MCP mod,接上 Claude 或任意 MCP agent,讓 AI 全自動遊玩《殺戮尖塔 2》。

Mod v0.3.4 · 適配 STS2 v0.103.2 · MIT 授權 · Windows / macOS / Linux

STS2 MCP 是什麼?

STS2 MCP 是一個社群 mod,把《殺戮尖塔 2》的遊戲狀態與操作透過 localhost REST API 暴露出來,並附帶一個可選的 MCP server。把 AI agent 指向它,模型就能讀取牌局並自行打完整局——這是一個把 STS2 對局完全自動化的實驗性專案。

  • 單人與合作(co-op)模式全自動,涵蓋選單、大廳與角色選擇
  • 透過 localhost:15526 上的 HTTP 即時讀取遊戲狀態
  • 存檔進度、圖鑑(compendium),以及對已解鎖卡牌/遺物的模糊 wiki 搜尋
  • 相容 Claude Code、Claude Desktop,或任意自訂 MCP 用戶端

環境需求

《殺戮尖塔 2》本體(已在 v0.103.2 上測試)

Python 3.11+ 與 uv 套件管理器(僅 MCP server 需要)

Claude Code、Claude Desktop,或其他支援 MCP 的用戶端

第一步 —— 安裝 Mod

Mod 就是一個 DLL 加一個清單檔。把兩者丟進遊戲的 mods 資料夾,HTTP server 會自動啟動。

  1. 1

    從 GitHub 倉庫下載最新 release。

  2. 2

    把 STS2_MCP.dll 與 STS2_MCP.json 複製到 [遊戲安裝目錄]/mods/。下載

  3. 3

    啟動遊戲,在設定裡啟用 mods。

  4. 4

    HTTP server 會自動在 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"}

第二步 —— 接上你的 AI

可選的 MCP server 讓 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 工具參考

如果你要自己寫 agent,這些就是 mod 暴露的介面。REST 端點可直接存取;MCP server 把它們包裝成工具。

REST 端點

GET /api/v1/profile當前存檔的持久化進度摘要。
GET /api/v1/compendium高層進度:卡牌庫、遺物、藥水、怪物圖鑑、角色統計與對局歷史。
GET /api/v1/wiki?query=...對已解鎖卡牌與遺物做模糊搜尋(預設 10 筆結果,可用 limit 覆寫)。
GET /api/v1/profiles列出三個存檔欄位以及當前啟用的存檔。
POST /api/v1/profiles切換或刪除某個存檔欄位。

MCP server 工具

get_game_state()當前遊戲狀態。
get_profile()當前存檔資料。
get_compendium()來自主選單或當前對局的持久上下文。
search_wiki(query, item_type, limit)按需查詢卡牌或遺物。
list_profiles()列出存檔欄位。
switch_profile(profile_id)切換當前存檔。
delete_profile(profile_id)刪除某個存檔欄位。

Token 消耗

全自動遊玩相當耗 token:用 Claude Sonnet 4.6 打完一整局鐵甲戰士(Ironclad)大約需要 800 萬 token(輸入、輸出與工具回應合計),GPT-5.4 約為 734 萬。在讓 agent 刷進階之前,記得先規劃好 API 預算。

STS2 MCP 是 Gennadiyev 的開源專案,以 MIT 授權發布。release、原始碼與 issue 請見倉庫。

在 GitHub 查看