gennadiyev/sts2mcp

Slay the Spire 2 플레이를 완전 자동화하는 실험적 연구 프로젝트

Slay the Spire 2의 모드로, AI 에이전트가 게임을 플레이할 수 있게 해줍니다. 로컬 호스트 REST API를 통해 게임 상태와 동작을 노출하며, 선택적으로 Claude 데스크톱/Claude 코드 통합을 위한 MCP 서버가 있습니다.

싱글플레이어 및 멀티플레이어(협동) 지원, 전체 메뉴 및 로비 조작: 프로필 전환, 캐릭터 선택(SP 및 멀티플레이어 호스트/클라이언트, 선택적 시드), 멀티플레이어 호스트 / 스팀 친구 가입 / FastMP 로컬 호스트 참여, 저장된 협동 플레이 재개를 위한 멀티플레이어 로비, 게임 종료, FTUE/튜토리얼 팝업 처리, 타임라인 가시성. STS2 v0.103.2에서 테스트됨.

[!경고] 이 모드는 외부 프로그램이 localhost API를 통해 게임을 읽고 제어할 수 있게 해줍니다. 관심 없는 플레이는 본인 책임 하에 사용하세요.

[!주의] 멀티플레이 지원은 베타 단계에 있으며 버그가 발생할 수 있습니다. 이 모드를 설치했을 때 발생하는 멀티플레이어 문제는 게임 자체가 아니라 모드 자체 문제일 가능성이 큽니다. STS2 개발자에게 버그를 보고하기 전에 모드를 비활성화하고 문제가 계속되는지 확인해 주세요.

플레이어를 위해

1. 모드를 설치하세요

최신 버전을 구입하고 지침을 따르세요:

An Experimental Research Project to Fully-Automate your Slay the Spire 2 Runs

A mod for Slay the Spire 2 that lets AI agents play the game. Exposes game state and actions via a localhost REST API, with an optional MCP server for Claude Desktop / Claude Code integration.

Singleplayer and multiplayer (co-op) supported, plus full menu and lobby control: profile switching, character select (SP and MP host/client) with optional seed, multiplayer host / Steam-friend join / FastMP localhost join, multiplayer load lobby for resuming saved co-op runs, game-over dismissal, FTUE/tutorial popup handling, and Timeline visibility. Tested against STS2 v0.103.2.

[!warning] This mod allows external programs to read and control your game via a localhost API. Use at your own risk with runs you care less about.

[!caution] Multiplayer support is in beta — expect bugs. Any multiplayer issues encountered with this mod installed are very likely caused by the mod, not the game. Please disable the mod and verify the issue persists before reporting bugs to the STS2 developers.

For Players

1. Install the Mod

Grab the latest release and follow the instructions:

1. Copy STS2_MCP.dll and STS2_MCP.json to /mods/
2. Launch the game and enable mods in settings (a consent dialog appears on first launch)
3. The mod starts an HTTP server on localhost:15526 automatically

[!note] The release DLL is a platform-agnostic .NET assembly — the same STS2_MCP.dll and STS2_MCP.json work on Windows, Linux, and macOS. No separate builds are needed.

macOS install

On macOS, the mods directory lives inside the app bundle. The default Steam install path is:

~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/
    SlayTheSpire2.app/Contents/MacOS/mods/

To install, right-click SlayTheSpire2.app → Show Package Contents, navigate to Contents/MacOS/, and create a mods folder. Or from the terminal:

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/"

Launch the game and open Settings → Mods. The mod should appear in the list. A consent dialog appears on first launch — accept it to enable mod loading. Once enabled, verify the HTTP server is running:

curl -s http://localhost:15526/

A successful response looks like:

{"message": "Hello from STS2 MCP v0.3.4", "status": "ok"}

If you get “Connection refused”, the mod is not loaded — check that mods are enabled in the game’s settings.

2. Give Your AI Instructions to Interact with the Game