Sts2 Agent

STS2 AI代理

https://github.com/user-attachments/assets/89353468-a299-4315-9516-e520bcbfbd4b

中文版说明请见 README.zh-CN.md.

STS2 AI Agent 是Slay the Spire 2 mod+MCP服务器捆绑包：

• STS2AIAgent：通过本地HTTP API公开游戏状态和操作
• mcp_server：将本地API包装为AI客户端的MCP服务器

详细的MCP工具文档位于 mcp_server/README.md。如果您希望在其上创建代理工作流，请从以下步骤开始 技能/sts2 mcp玩家/SKILL.md.

快速开始

1.安装Mod

下载并解压缩发布包后，将这些文件复制到您的游戏中 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.启动游戏并确认Mod已加载

正常启动游戏，以便模组可以加载。

然后打开：

http://127.0.0.1:8080/health

如果端点响应，则mod正在运行。

3.启动MCP服务器

先准备环境：

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

安装 uv 在Windows上：

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

在macOS上：

brew install uv

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

窗户：

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上工作得更好，请启动网络服务器。

窗户：

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

macOS/Linux：

./scripts/start-mcp-network.sh

默认MCP端点：

http://127.0.0.1:8765/mcp

项目能做什么

当前 main 该分支为STS2提供了一个可播放的MCP集成，包括：

• 读取实时游戏状态
• 列出当前的法律行动
• 驾驶战斗、奖励、商店、地图路线、事件、休息地点、箱子、顶点选择和捆绑选择
• 为AlphaZero训练提供丰富的战斗和运行有效载荷（提升、行动/老板ID、敌人/移动ID）
• resolve_rewards 受控奖励决议的原子行为
• 通过SSE事件减少轮询
• 暴露MCP stdio 或HTTP
• 通过Mod API为卡、遗迹、怪物、药剂和事件提供实时游戏元数据
• 支持分层规划器/作战代理切换流
• increase_ascension / decrease_ascension 字符选择中的控件

看 mcp_server/README.md 用于查看详细的工具表面。

常见问题

http://127.0.0.1:8080/health 无法打开

先检查一下：

1. 游戏实际上正在运行
2. STS2AIAgent.dll, STS2AIAgent.pck，以及 mod_id.json 都在游戏里 mods/ 目录
3. 操作系统没有复制或重命名这些文件
4. 您将它们复制到Steam游戏目录，而不是存储库目录

MCP服务器启动但无法读取游戏状态

这通常意味着 mcp_server 正在运行，但游戏中的mod未连接。确认：

1. 游戏正在运行
2. http://127.0.0.1:8080/health 可以联系到
3. MCP服务器仍指向 http://127.0.0.1:8080

我应该启用调试操作吗？

通常不会。

仅限开发人员的操作，例如 run_console_command 默认情况下是禁用的，在正常使用和发布时应保持禁用状态。

从源头构建

如果您是从源代码构建而不是使用发布包：

窗户：

powershell -ExecutionPolicy Bypass -File ".\scripts\build-mod.ps1" -Configuration Release

macOS/Linux：

./scripts/build-mod.sh --configuration Release

更完整的环境、路径发现和验证说明在 build-and-env.md.

仓库的规划

• STS2AIAgent/：游戏模组来源
• mcp_server/：MCP服务器源
• scripts/：启动、生成和验证脚本
• docs/：证明文件
• skills/：同伴技能

许可证

本项目仅根据GNU Affero通用公共许可证v3.0（仅AGPL-3.0）获得许可。