工具

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 查看