Outils

STS2 MCP —— Guide de configuration de l’auto-jeu par IA

Installez le mod STS2 MCP et connectez Claude ou n’importe quel agent MCP pour jouer à Slay the Spire 2 sans les mains.

Mod v0.3.4 · Testé sur STS2 v0.103.2 · Licence MIT · Windows / macOS / Linux

Qu’est-ce que STS2 MCP ?

STS2 MCP est un mod communautaire qui expose l’état de jeu et les commandes de Slay the Spire 2 via une API REST en localhost, plus un serveur MCP optionnel. Pointez un agent IA dessus et le modèle peut lire le plateau et jouer des runs complètes tout seul — un projet expérimental pour automatiser entièrement vos runs STS2.

  • Automatisation complète en solo et en coopération (co-op), y compris menu, lobby et sélection de personnage
  • État de jeu en temps réel via HTTP sur localhost:15526
  • Progression du profil, compendium et recherche wiki floue des cartes et reliques découvertes
  • Compatible avec Claude Code, Claude Desktop ou tout client MCP personnalisé

Prérequis

Jeu de base Slay the Spire 2 (testé sur v0.103.2)

Python 3.11+ et le gestionnaire de paquets uv (nécessaire uniquement pour le serveur MCP)

Claude Code, Claude Desktop ou un autre client compatible MCP

Étape 1 — Installer le mod

Le mod est une seule DLL plus un manifeste. Placez les deux dans le dossier mods du jeu et le serveur HTTP démarre tout seul.

  1. 1

    Téléchargez la dernière release depuis le dépôt GitHub.

  2. 2

    Copiez STS2_MCP.dll et STS2_MCP.json dans [installation_du_jeu]/mods/.Télécharger

  3. 3

    Lancez le jeu et activez les mods dans les paramètres.

  4. 4

    Le serveur HTTP démarre automatiquement sur localhost:15526.

Chemin d’installation macOS

Sur macOS, le dossier mods se trouve à l’intérieur de l’app bundle. Exécutez ces commandes pour le créer et y copier les fichiers.

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

Vérifier l’installation

Le jeu lancé, appelez le endpoint racine. Une installation saine renvoie un message de bienvenue avec la version.

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

Étape 2 — Connecter votre IA

Le serveur MCP optionnel permet à Claude de communiquer avec le mod via des appels d’outils. Il faut Python 3.11+ et uv.

Ajoutez ce bloc à votre .mcp.json de Claude Code ou au claude_desktop_config.json de Claude Desktop, en pointant directory vers votre copie locale.

{
  "mcpServers": {
    "sts2": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/STS2MCP/mcp", "python", "server.py"]
    }
  }
}
Sur macOS, utilisez le chemin absolu vers uv (p. ex. /opt/homebrew/bin/uv) dans le champ command, sinon Claude risque de ne pas le trouver.

Options facultatives

  • --host et --port pour utiliser une adresse non par défaut.
  • --no-trust-env pour ignorer les variables d’environnement de proxy.
Redémarrez Claude après avoir modifié la configuration, puis demandez-lui d’exécuter get_game_state pour confirmer la connexion.

Référence API et outils MCP

Si vous construisez votre propre agent, voici les surfaces exposées par le mod. Les endpoints REST sont accessibles directement ; le serveur MCP les enveloppe en outils.

Endpoints REST

GET /api/v1/profileRésumé de progression persistant du profil actif.
GET /api/v1/compendiumProgression globale : bibliothèque de cartes, reliques, potions, bestiaire, statistiques de personnage et historique des runs.
GET /api/v1/wiki?query=...Recherche floue parmi les cartes et reliques découvertes (10 résultats par défaut, modifiable avec limit).
GET /api/v1/profilesListe les trois emplacements de profil et celui actif.
POST /api/v1/profilesChanger ou supprimer un emplacement de profil.

Outils du serveur MCP

get_game_state()État de jeu actuel.
get_profile()Données du profil actif.
get_compendium()Contexte durable du menu principal ou d’une run en cours.
search_wiki(query, item_type, limit)Recherche ciblée de carte ou de relique.
list_profiles()Lister les emplacements de profil.
switch_profile(profile_id)Changer le profil actif.
delete_profile(profile_id)Supprimer un emplacement de profil.

Coût en tokens

L’auto-jeu complet consomme beaucoup de tokens : environ 8 M pour une run Ironclad complète avec Claude Sonnet 4.6 (entrée, sortie et réponses d’outils cumulées), et près de 7,34 M avec GPT-5.4. Prévoyez votre budget API en conséquence avant de laisser un agent farmer les ascensions.

STS2 MCP est un projet open source de Gennadiyev, publié sous licence MIT. Pour les releases, le code source et les issues, consultez le dépôt.

Voir sur GitHub