STS2 MCP —— AI 自動遊玩設定教學
安裝 STS2 MCP mod,接上 Claude 或任意 MCP agent,讓 AI 全自動遊玩《殺戮尖塔 2》。
Mod v0.3.4 · 適配 STS2 v0.103.2 · MIT 授權 · Windows / macOS / LinuxSTS2 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
從 GitHub 倉庫下載最新 release。
- 2
把 STS2_MCP.dll 與 STS2_MCP.json 複製到 [遊戲安裝目錄]/mods/。下載
- 3
啟動遊戲,在設定裡啟用 mods。
- 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"]
}
}
}可選參數
- --host 與 --port:在非預設位址上執行。
- --no-trust-env:忽略代理環境變數。
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 查看