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