Herramientas

STS2 MCP —— Guía de configuración del autojuego con IA

Instala el mod STS2 MCP y conecta Claude o cualquier agente MCP para jugar Slay the Spire 2 sin manos.

Mod v0.3.4 · Probado en STS2 v0.103.2 · Licencia MIT · Windows / macOS / Linux

¿Qué es STS2 MCP?

STS2 MCP es un mod comunitario que expone el estado y los controles de Slay the Spire 2 a través de una API REST en localhost, más un servidor MCP opcional. Apunta un agente de IA hacia él y el modelo podrá leer el tablero y jugar partidas completas por su cuenta: un proyecto experimental para automatizar por completo tus partidas de STS2.

  • Automatización total en un jugador y cooperativo (co-op), incluidos menú, sala y selección de personaje
  • Estado del juego en tiempo real por HTTP en localhost:15526
  • Progreso del perfil, compendio y búsqueda wiki difusa de cartas y reliquias descubiertas
  • Compatible con Claude Code, Claude Desktop o cualquier cliente MCP propio

Requisitos

Juego base Slay the Spire 2 (probado en v0.103.2)

Python 3.11+ y el gestor de paquetes uv (solo para el servidor MCP)

Claude Code, Claude Desktop u otro cliente compatible con MCP

Paso 1 — Instalar el mod

El mod es una sola DLL más un manifiesto. Coloca ambos en la carpeta mods del juego y el servidor HTTP arrancará solo.

  1. 1

    Descarga la última release desde el repositorio de GitHub.

  2. 2

    Copia STS2_MCP.dll y STS2_MCP.json en [instalación_del_juego]/mods/.Descargar

  3. 3

    Inicia el juego y activa los mods en los ajustes.

  4. 4

    El servidor HTTP arranca automáticamente en localhost:15526.

Ruta de instalación en macOS

En macOS la carpeta mods está dentro del app bundle. Ejecuta estos comandos para crearla y copiar los archivos.

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

Verificar la instalación

Con el juego en marcha, accede al endpoint raíz. Una instalación correcta devuelve un saludo con la versión.

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

Paso 2 — Conectar tu IA

El servidor MCP opcional permite que Claude hable con el mod mediante llamadas a herramientas. Necesita Python 3.11+ y uv.

Añade este bloque a tu .mcp.json de Claude Code o al claude_desktop_config.json de Claude Desktop, apuntando directory a tu copia local.

{
  "mcpServers": {
    "sts2": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/STS2MCP/mcp", "python", "server.py"]
    }
  }
}
En macOS, usa la ruta absoluta a uv (p. ej. /opt/homebrew/bin/uv) en el campo command; de lo contrario Claude podría no encontrarlo.

Flags opcionales

  • --host y --port para ejecutar en una dirección distinta a la predeterminada.
  • --no-trust-env para ignorar las variables de entorno de proxy.
Reinicia Claude tras editar la configuración y pídele que ejecute get_game_state para confirmar la conexión.

Referencia de API y herramientas MCP

Si construyes tu propio agente, estas son las superficies que expone el mod. Los endpoints REST son accesibles directamente; el servidor MCP los envuelve como herramientas.

Endpoints REST

GET /api/v1/profileResumen de progreso persistente del perfil activo.
GET /api/v1/compendiumProgreso general: biblioteca de cartas, reliquias, pociones, bestiario, estadísticas de personaje e historial de partidas.
GET /api/v1/wiki?query=...Búsqueda difusa entre cartas y reliquias descubiertas (10 resultados por defecto, ajustable con limit).
GET /api/v1/profilesLista las tres ranuras de perfil y la activa.
POST /api/v1/profilesCambiar o eliminar una ranura de perfil.

Herramientas del servidor MCP

get_game_state()Estado actual del juego.
get_profile()Datos del perfil activo.
get_compendium()Contexto duradero del menú principal o de una partida en curso.
search_wiki(query, item_type, limit)Consulta selectiva de cartas o reliquias.
list_profiles()Listar las ranuras de perfil.
switch_profile(profile_id)Cambiar el perfil activo.
delete_profile(profile_id)Eliminar una ranura de perfil.

Coste en tokens

El autojuego completo consume muchos tokens: alrededor de 8 M para una partida completa de Ironclad con Claude Sonnet 4.6 (entrada, salida y respuestas de herramientas combinadas), y unos 7,34 M con GPT-5.4. Planifica tu presupuesto de API antes de dejar que un agente farmee ascensiones.

STS2 MCP es un proyecto de código abierto de Gennadiyev, publicado bajo licencia MIT. Para releases, código y problemas, consulta el repositorio.

Ver en GitHub