Slay the Spire Copilot

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： ``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要注意什么？ ``

工具列表

| 工具 | 功能 | |------|------| | check_connection | 检查游戏连接状态 | | get_game_state | 获取完整游戏状态 | | get_screen_state | 获取当前屏幕快照 | | get_available_actions | 获取当前可用操作 | | get_card_info | 查询卡牌详情 | | execute_actions | 批量执行操作 | | play_card | 出牌 | | end_turn | 结束回合 | | choose | 做出选择 | | use_potion | 使用药水 | | discard_potion | 丢弃药水 | | proceed | 继续/确认 | | skip | 跳过 | | start_game | 开始新游戏 | | continue_game | 继续存档 | | abandon_run | 放弃当前游戏 |

备选方案：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 | CommunicationMod | |------|-------------|-------------------| | 协议 | MCP over HTTP | stdin/stdout + TCP | | 批量操作 | 支持（稳定索引） | 逐条命令 | | 卡牌查询 | 支持 | 不支持 | | 成熟度 | 较新 | 经典，广泛使用 | | 安装难度 | 需要手动安装 | Steam Workshop 直接订阅 |

配置

| 环境变量 | 默认值 | 说明 | |---------|--------|------| | SPIRE_URL | http://127.0.0.1:8080/mcp | MCPTheSpire 地址 | | SPIRE_BACKEND | mcp | 后端选择：mcp 或 comm | | COMM_HOST | 127.0.0.1 | CommunicationMod bridge 地址 | | COMM_PORT | 38765 | CommunicationMod bridge 端口 |

故障排查

| 问题 | 解决方案 | |------|---------| | 连接失败 | 确认游戏已启动且 MCPTheSpire mod 已启用 | | 端口冲突 | 修改 MCPTheSpire 配置中的端口，同步修改 SPIRE_URL | | mod 加载失败 | 确认 ModTheSpire 和 BaseMod 版本兼容 | | Python 依赖错误 | 运行 pip install -r requirements.txt |

参考项目

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

协议

MIT License