Инструменты

STS2 MCP —— Гид по настройке авто-игры с ИИ

Установите мод STS2 MCP и подключите Claude или любой MCP-агент, чтобы играть в Slay the Spire 2 без рук.

Мод v0.3.4 · Проверено на STS2 v0.103.2 · Лицензия MIT · Windows / macOS / Linux

Что такое STS2 MCP?

STS2 MCP — это community-мод, который открывает состояние игры и управление Slay the Spire 2 через localhost REST API, плюс опциональный MCP-сервер. Направьте на него ИИ-агента, и модель сможет читать поле и проходить целые забеги сама — экспериментальный проект для полной автоматизации ваших забегов STS2.

  • Полная автоматизация в одиночном и кооперативном (co-op) режимах, включая меню, лобби и выбор персонажа
  • Состояние игры в реальном времени по HTTP на localhost:15526
  • Прогресс профиля, компендиум и нечёткий wiki-поиск по открытым картам и реликвиям
  • Работает с Claude Code, Claude Desktop или любым своим MCP-клиентом

Требования

Базовая игра Slay the Spire 2 (проверено на v0.103.2)

Python 3.11+ и пакетный менеджер uv (нужны только для MCP-сервера)

Claude Code, Claude Desktop или другой клиент с поддержкой MCP

Шаг 1 — Установка мода

Мод — это одна DLL плюс манифест. Положите оба файла в папку mods игры, и HTTP-сервер запустится сам.

  1. 1

    Скачайте последний релиз из репозитория GitHub.

  2. 2

    Скопируйте STS2_MCP.dll и STS2_MCP.json в [папка_игры]/mods/.Скачать

  3. 3

    Запустите игру и включите моды в настройках.

  4. 4

    HTTP-сервер автоматически запускается на localhost:15526.

Путь установки на macOS

На macOS папка mods находится внутри app bundle. Выполните эти команды, чтобы создать её и скопировать файлы.

GAME_DIR="$HOME/Library/Application Support/Steam/steamapps/common/Slay the Spire 2"
MODS_DIR="$GAME_DIR/SlayTheSpire2.app/Contents/MacOS/mods"
mkdir -p "$MODS_DIR"
cp STS2_MCP.dll "$MODS_DIR/"
cp STS2_MCP.json "$MODS_DIR/"

Проверка установки

При запущенной игре обратитесь к корневому эндпоинту. Исправная установка вернёт приветствие с версией.

curl -s http://localhost:15526/
{"message": "Hello from STS2 MCP v0.3.4", "status": "ok"}

Шаг 2 — Подключение ИИ

Опциональный MCP-сервер позволяет Claude общаться с модом через вызовы инструментов. Нужны Python 3.11+ и uv.

Добавьте этот блок в .mcp.json для Claude Code или claude_desktop_config.json для Claude Desktop, указав в directory путь к локальной копии.

{
  "mcpServers": {
    "sts2": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/STS2MCP/mcp", "python", "server.py"]
    }
  }
}
На macOS укажите в поле command абсолютный путь к uv (например, /opt/homebrew/bin/uv), иначе Claude может его не найти.

Опциональные флаги

  • --host и --port для запуска на нестандартном адресе.
  • --no-trust-env, чтобы игнорировать прокси-переменные окружения.
Перезапустите Claude после редактирования конфигурации, затем попросите его выполнить get_game_state, чтобы подтвердить подключение.

Справочник API и MCP-инструментов

Если вы пишете собственного агента, вот интерфейсы, которые открывает мод. REST-эндпоинты доступны напрямую; MCP-сервер оборачивает их в инструменты.

REST-эндпоинты

GET /api/v1/profileПостоянная сводка прогресса активного профиля.
GET /api/v1/compendiumОбщий прогресс: библиотека карт, реликвии, зелья, бестиарий, статистика персонажей и история забегов.
GET /api/v1/wiki?query=...Нечёткий поиск по открытым картам и реликвиям (по умолчанию 10 результатов, переопределяется через limit).
GET /api/v1/profilesСписок трёх слотов профилей и активного.
POST /api/v1/profilesПереключить или удалить слот профиля.

Инструменты MCP-сервера

get_game_state()Текущее состояние игры.
get_profile()Данные активного профиля.
get_compendium()Устойчивый контекст из главного меню или активного забега.
search_wiki(query, item_type, limit)Выборочный поиск карты или реликвии.
list_profiles()Список слотов профилей.
switch_profile(profile_id)Переключить активный профиль.
delete_profile(profile_id)Удалить слот профиля.

Расход токенов

Полная авто-игра тратит много токенов: около 8 млн за полный забег Ironclad с Claude Sonnet 4.6 (ввод, вывод и ответы инструментов вместе) и примерно 7,34 млн с GPT-5.4. Планируйте бюджет API заранее, прежде чем поручать агенту фармить вознесения.

STS2 MCP — проект с открытым исходным кодом от Gennadiyev, выпущенный под лицензией MIT. Релизы, исходники и issue смотрите в репозитории.

Открыть на GitHub