MCP 服务器

Slay the Spire Copilot

Enables AI-assisted gameplay for Slay the Spire by reading game state and providing strategy advice or automated actions via Claude Code.

README

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 决策)

前置条件

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

安装步骤

1. 安装游戏 Mod

方式 A: Steam Workshop（推荐）

在 Steam Workshop 订阅 ModTheSpire
在 Steam Workshop 订阅 BaseMod

手动安装 MCPTheSpire:

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

方式 B: 手动安装

下载 ModTheSpire
下载 BaseMod
下载 MCPTheSpire
将所有 .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要注意什么？

工具列表

工具	功能
`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。

安装步骤

在 Steam Workshop 订阅 CommunicationMod，或从 GitHub Releases 下载
启动一次游戏，生成配置文件

编辑 SlayTheSpire/SlayTheSpire_Data/SpireConfig，设置：

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

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

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

启动游戏后，CommunicationMod 会自动启动 comm_bridge.py
在 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`