Slay the Spire Copilot

使用 Claude Code 辅助游玩杀戮尖塔（Slay the Spire）。AI 能读取游戏状态，在每一步给出策略建议或自动操作，辅助通关游戏。

架构

Slay the Spire (游戏)
    ↕ MCPTheSpire mod (HTTP, localhost:8080)
Python MCP Bridge Server (stdio)
    ↕ MCP 协议
Claude Code (AI 决策)

前置条件

1. Slay the Spire — Steam 版本
2. ModTheSpire — mod 加载器（Steam Workshop 订阅或手动安装）
3. BaseMod — 基础 mod 库（Steam Workshop 订阅或手动安装）
4. MCPTheSpire — MCP 通信 mod（GitHub）
5. Python 3.10+ — 运行 MCP bridge server
6. Claude Code — Anthropic 的 CLI 工具

安装步骤

1. 安装游戏 Mod

#### 方式 A: Steam Workshop（推荐）

1. 在 Steam Workshop 订阅 ModTheSpire
2. 在 Steam Workshop 订阅 BaseMod
3. 手动安装 MCPTheSpire:

   # 从 GitHub Releases 下载 MCPTheSpire.jar
   # 放入: <Steam>/steamapps/common/SlayTheSpire/mods/

#### 方式 B: 手动安装

1. 下载 ModTheSpire
2. 下载 BaseMod
3. 下载 MCPTheSpire
4. 将所有 .jar 文件放入 <Steam>/steamapps/common/SlayTheSpire/mods/ 目录

2. 安装 Python 依赖

cd slay-the-spire-copilot
pip install -r requirements.txt

3. 配置 Claude Code

项目已包含 .mcp.json 配置文件。在此目录启动 Claude Code 即会自动加载 MCP server：

cd slay-the-spire-copilot
claude

或手动添加到全局配置 ~/.claude/settings.json：

{
  "mcpServers": {
    "slay-the-spire": {
      "command": "python",
      "args": ["C:/Users/PC/slay-the-spire-copilot/src/server.py"],
      "env": {
        "SPIRE_URL": "http://127.0.0.1:8080/mcp"
      }
    }
  }
}

使用方法

1. 启动游戏

• 通过 ModTheSpire 启动杀戮尖塔
• 确保 MCPTheSpire mod 已勾选启用
• 等待游戏加载完成（MCPTheSpire 会在 8080 端口启动 MCP 服务）

2. 启动 Claude Code

cd slay-the-spire-copilot
claude

3. 开始游玩

顾问模式（推荐）：

> 帮我看看当前局势，应该怎么打？
> 这三张卡选哪张好？
> 地图应该走哪条路？
> 这个事件选哪个选项？

自动游玩模式：

> 帮我开一局铁甲战士，0级升阶，自动打
> 自动帮我打完这场战斗
> 帮我做出这个选择并继续

分析模式：

> 分析一下我当前的牌组强度
> 我的牌组缺什么？需要找什么卡？
> 接下来的boss要注意什么？

工具列表

备选方案：CommunicationMod 后端

如果不想安装 MCPTheSpire，可以使用更经典的 CommunicationMod。

安装步骤

1. 在 Steam Workshop 订阅 CommunicationMod，或从 GitHub Releases 下载
2. 启动一次游戏，生成配置文件
3. 编辑 SlayTheSpire/SlayTheSpire_Data/SpireConfig，设置：

   command=D:/Develop/Anaconda/python.exe
   argument=C:/Users/PC/slay-the-spire-copilot/src/comm_bridge.py

1. 修改 .mcp.json，添加环境变量：

   {
     "mcpServers": {
       "slay-the-spire": {
         "command": "D:/Develop/Anaconda/python.exe",
         "args": ["src/server.py"],
         "env": {
           "SPIRE_BACKEND": "comm"
         }
       }
     }
   }

1. 启动游戏后，CommunicationMod 会自动启动 comm_bridge.py
2. 在 Claude Code 中照常使用

两种后端对比

配置

故障排查

参考项目

• MCPTheSpire — MCP 游戏通信 mod
• STSAgent — LLM 游戏内助手 mod
• STS-AISlayer — AI 控制 mod
• CommunicationMod — 经典外部进程通信 mod

协议

MIT License