STS2MCP

Мод Slay the Spire 2 и MCP-сервер: Claude Code или Claude Desktop читают состояние игры и проходят забег сами

  • 535 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Мод открывает на localhost API, через которое внешняя программа читает состояние игры и управляет ею
  • Агент может переключать и удалять слоты профиля инструментом delete_profile вместе с прогрессом
  • Мод загружается в клиент игры, поэтому его сбои могут влиять на сохранения и запуск
Все причины и проверки

gennadiyev/sts2mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/sts2mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Мод открывает на localhost API, через которое внешняя программа читает состояние игры и управляет ею
  • Агент может переключать и удалять слоты профиля инструментом delete_profile вместе с прогрессом
  • Мод загружается в клиент игры, поэтому его сбои могут влиять на сохранения и запуск

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

STS2MCP состоит из двух частей. Мод для Slay the Spire 2 поднимает на машине игрока локальный HTTP-сервер, который отдает состояние игры и принимает команды. Второй частью служит MCP-сервер на Python в папке mcp: он превращает этот интерфейс в инструменты для Claude Desktop, Claude Code и других клиентов. Инструментом get_game_state агент читает состояние боя. Дальше он разыгрывает карты и зелья, завершает ход и ведет забег по карте. Через menu_select он управляет меню и лобби: выбирает персонажа и сид, начинает одиночную игру или кооператив. Отдельные инструменты читают профиль, справочник и вики по открытым картам и реликвиям, а также переключают профили. Автор называет проект исследовательским экспериментом: он проверяет, как языковые модели справляются с редкой для них задачей. Мод работает на Windows, Linux и macOS, одна и та же сборка DLL подходит для всех систем. Без MCP-сервера агент может играть по документам docs/raw-full.md и docs/raw-simplified.md, если дать их ему напрямую.

Для кого. Игрокам и исследователям агентов, которые хотят посмотреть, как Claude проходит Slay the Spire 2, или проверить модели на играх с долгой цепочкой решений.

Подходит, если

  • Нужно сравнить, как разные модели принимают решения в карточной игре с длинным забегом
  • Хочется поиграть в кооператив вместе с агентом: поддерживаются хост, подключение через друга в Steam и локальное подключение
  • Требуется быстро проверить идею агента на игре без своего интерфейса: состояние и действия уже даны как инструменты
  • Нужен справочник по открытым картам и реликвиям вашего профиля для агента-советчика: его дает search_wiki
  • Нужно подключить игру к клиенту, который поддерживает MCP, например Claude Code через файл .mcp.json

Не подходит, если

  • Играете на аккаунте с забегами, которые вам дороги: автор советует использовать проект на забегах, которые не жалко потерять
  • Нужен стабильный кооператив: мультиплеер пока в бета-версии
  • Хотите сообщить разработчикам игры об ошибке: сначала отключите мод и проверьте, что ошибка остается
  • Вы хотите просто сыграть сами: забег под управлением агента стоит нескольких миллионов токенов

Пример запроса к агенту

Вызови get_game_state, опиши, что сейчас происходит в бою, и сыграй ход так, чтобы потерять как можно меньше здоровья

MCP

Транспорт
stdio
Авторизация
не нужна

Ограничения

  • Мод проверен на версии Slay the Spire 2 0.103.2. Обновление игры может его сломать.
  • Мультиплеер в бете. Любые сбои с установленным модом, скорее всего, вызваны им.
  • Для MCP-сервера нужны Python 3.11 или новее и uv. На macOS в поле command указывайте абсолютный путь к uv, потому что графические приложения не наследуют PATH.
  • Нужна установленная игра. Для сборки мода из исходников требуется .NET 9 SDK.

Как отключить. Удалите файлы STS2_MCP.dll и STS2_MCP.json из папки mods игры или отключите мод в настройках игры. MCP-сервер уберите из .mcp.json или claude_desktop_config.json.

Частые вопросы

Как подключить STS2MCP к Claude Code?

Скопируйте STS2_MCP.dll и STS2_MCP.json из релиза в папку mods игры и включите моды в настройках. Затем добавьте в .mcp.json сервер sts2 с командой uv и аргументами run, --directory, путь к папке mcp, python, server.py. После перезапуска попросите Claude вызвать get_game_state при запущенной игре.

Где лежит папка mods в macOS?

Внутри пакета приложения: ~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/SlayTheSpire2.app/Contents/MacOS/mods/. Если папки нет, создайте ее командой mkdir -p. Меню Show Package Contents в Finder открывает содержимое пакета.

Сколько токенов уходит на один забег?

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

Это чит-мод?

Мод не меняет игровой процесс, он только дает внешним программам интерфейс к игре. Что вы с ним делаете, решаете сами. Автор подчеркивает, что хотел проверять модели на редкой задаче и не собирается заменять игроков.

Как проверить, что мод запущен?

Выполните curl -s http://localhost:15526/. Рабочий мод вернет JSON с сообщением Hello from STS2 MCP и статусом ok. Если приходит Connection refused, мод не загрузился: проверьте, что моды включены в настройках игры.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Мод для Slay the Spire 2 со встроенным MCP: внешний агент читает состояние боя и сам выбирает действия

MCP-серверРасширенный доступ351Звезды репозитория

CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода

CLIШирокий доступ2,4 тыс.Звезды репозитория

MCP-сервер реестра HeyClaude только для чтения: агент ищет скиллы, MCP-серверы и хуки и получает готовые команды установки

MCP-серверРасширенный доступ304Звезды репозитория

MCP-сервер с векторным поиском: агент описывает задачу и получает подходящие скиллы из коллекций Anthropic и K-Dense

MCP-серверРасширенный доступ411Звезды репозитория

CLI на Python без зависимостей: один каталог MCP-серверов и скиллов для всех агентов, в контекст попадает краткий индекс

CLIШирокий доступ405Звезды репозитория

Локальный MCP-сервер, который ведет журнал рассуждений агента по стадиям с сохранением сессий, решений и обоснований

MCP-серверРасширенный доступ959Звезды репозитория

Коротко о README

README делится на разделы для игроков и для разработчиков. Для игроков в нем установка мода по системам, настройка MCP-сервера и описание профиля и справочника. Разработчикам нужны сборка и копирование на macOS, а завершает документ FAQ о мотивации автора и расходе токенов.

Бейдж для README

Сообщить о проблеме

Foxx AISTS2MCP
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.