Tools

STS2 MCP —— Einrichtungsguide für KI-Autoplay

Installiere das STS2-MCP-Mod und verbinde Claude oder einen beliebigen MCP-Agenten, um Slay the Spire 2 freihändig zu spielen.

Mod v0.3.4 · Getestet mit STS2 v0.103.2 · MIT-Lizenz · Windows / macOS / Linux

Was ist STS2 MCP?

STS2 MCP ist ein Community-Mod, das den Spielzustand und die Steuerung von Slay the Spire 2 über eine localhost-REST-API freigibt, plus einen optionalen MCP-Server. Richte einen KI-Agenten darauf aus, und das Modell kann das Brett lesen und ganze Runs selbst spielen – ein experimentelles Projekt zur vollständigen Automatisierung deiner STS2-Runs.

  • Vollautomatisierung in Einzel- und Koop-Modus (co-op), inkl. Menü, Lobby und Charakterauswahl
  • Echtzeit-Spielzustand per HTTP auf localhost:15526
  • Profilfortschritt, Kompendium und unscharfe Wiki-Suche für entdeckte Karten und Relikte
  • Funktioniert mit Claude Code, Claude Desktop oder jedem eigenen MCP-Client

Voraussetzungen

Slay the Spire 2 Basisspiel (getestet mit v0.103.2)

Python 3.11+ und der Paketmanager uv (nur für den MCP-Server nötig)

Claude Code, Claude Desktop oder ein anderer MCP-fähiger Client

Schritt 1 — Mod installieren

Das Mod ist eine einzelne DLL plus Manifest. Lege beides in den mods-Ordner des Spiels, und der HTTP-Server startet von selbst.

  1. 1

    Lade das neueste Release aus dem GitHub-Repository herunter.

  2. 2

    Kopiere STS2_MCP.dll und STS2_MCP.json nach [Spielinstallation]/mods/.Herunterladen

  3. 3

    Starte das Spiel und aktiviere Mods in den Einstellungen.

  4. 4

    Der HTTP-Server startet automatisch auf localhost:15526.

macOS-Installationspfad

Unter macOS liegt der mods-Ordner im App-Bundle. Führe diese Befehle aus, um ihn anzulegen und die Dateien hineinzukopieren.

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

Installation prüfen

Rufe bei laufendem Spiel den Root-Endpunkt auf. Eine intakte Installation liefert eine Versionsbegrüßung zurück.

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

Schritt 2 — KI verbinden

Der optionale MCP-Server lässt Claude per Tool-Aufrufen mit dem Mod kommunizieren. Er benötigt Python 3.11+ und uv.

Füge diesen Block in deine Claude Code .mcp.json oder Claude Desktop claude_desktop_config.json ein und richte directory auf dein lokales Checkout aus.

{
  "mcpServers": {
    "sts2": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/STS2MCP/mcp", "python", "server.py"]
    }
  }
}
Verwende unter macOS im command-Feld den absoluten Pfad zu uv (z. B. /opt/homebrew/bin/uv), sonst findet Claude es eventuell nicht.

Optionale Flags

  • --host und --port für eine abweichende Adresse.
  • --no-trust-env, um Proxy-Umgebungsvariablen zu ignorieren.
Starte Claude nach dem Bearbeiten der Konfiguration neu und lass es get_game_state ausführen, um die Verbindung zu bestätigen.

API- & MCP-Tool-Referenz

Wenn du deinen eigenen Agenten baust, sind dies die Schnittstellen des Mods. REST-Endpunkte sind direkt erreichbar; der MCP-Server kapselt sie als Tools.

REST-Endpunkte

GET /api/v1/profilePersistente Fortschrittsübersicht des aktiven Profils.
GET /api/v1/compendiumÜbergeordneter Fortschritt: Kartenbibliothek, Relikte, Tränke, Bestiarium, Charakterstatistiken und Run-Verlauf.
GET /api/v1/wiki?query=...Unscharfe Suche über entdeckte Karten und Relikte (standardmäßig 10 Treffer, mit limit überschreibbar).
GET /api/v1/profilesListet die drei Profil-Slots und das aktive Profil auf.
POST /api/v1/profilesProfil-Slot wechseln oder löschen.

MCP-Server-Tools

get_game_state()Aktueller Spielzustand.
get_profile()Daten des aktiven Profils.
get_compendium()Dauerhafter Kontext aus dem Hauptmenü oder einem aktiven Run.
search_wiki(query, item_type, limit)Gezielte Karten- oder Reliktsuche.
list_profiles()Profil-Slots auflisten.
switch_profile(profile_id)Aktives Profil wechseln.
delete_profile(profile_id)Profil-Slot löschen.

Token-Kosten

Vollautomatisches Spielen ist token-intensiv: rund 8 Mio. Token für einen kompletten Ironclad-Run mit Claude Sonnet 4.6 (Eingabe, Ausgabe und Tool-Antworten zusammen) und etwa 7,34 Mio. mit GPT-5.4. Plane dein API-Budget entsprechend, bevor du einen Agenten Aufstiege grinden lässt.

STS2 MCP ist ein Open-Source-Projekt von Gennadiyev, veröffentlicht unter der MIT-Lizenz. Releases, Quellcode und Issues findest du im Repository.

Auf GitHub ansehen