STS2 Agent

STS2 Agent

让AI玩《杀戮尖塔2》的游戏状态和操作通过本地HTTP API暴露，并封装为MCP服务器，使得支持MCP的AI客户端能直接调用。

游戏玩法

STS2 Agent预览查看大图

STS2 AI 代理

这是一个《杀戮尖塔2》模组与 MCP 服务器捆绑包：

  • STS2AIAgent：通过本地 HTTP API 暴露游戏状态和操作
  • mcp_server：将该本地 API 封装为 MCP 服务器，供 AI 客户端使用

快速开始

1. 安装模组

下载并解压发布包后，将这些文件复制到游戏的 mods/ 目录：

STS2AIAgent.dll
STS2AIAgent.pck
mod_id.json

Steam 默认安装路径通常为：

C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2

最终的文件结构应如下所示：

Slay the Spire 2/
  mods/
    STS2AIAgent.dll
    STS2AIAgent.pck
    mod_id.json

2. 启动游戏并确认模组已加载

正常启动游戏，使模组随之加载。然后打开：

http://127.0.0.1:8080/health

如果该端点有响应，则说明模组正在运行。

3. 启动 MCP 服务器

首先准备好环境：

  1. 安装 Python 3.11+
  2. 安装 uv

在 Windows 上安装 uv：

powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"

在 macOS 上安装：

brew install uv

然后启动默认的 stdio MCP 服务器。

Windows：

powershell -ExecutionPolicy Bypass -File ".\scripts\start-mcp-stdio.ps1"

macOS / Linux：

./scripts/start-mcp-stdio.sh

这是推荐的默认方式。大多数桌面 AI 客户端更倾向于 stdio MCP 集成。

4. 连接你的 MCP 客户端

如果你的客户端支持基于命令的 MCP 启动方式，请将其工作目录指向 mcp_server/，并使用：

uv run sts2-mcp-server

如果你的客户端更适合 HTTP 方式，请改用网络服务器启动。

Windows：

powershell -ExecutionPolicy Bypass -File ".\scripts\start-mcp-network.ps1"

macOS / Linux：

./scripts/start-mcp-network.sh

默认 MCP 端点：

http://127.0.0.1:8765/mcp