Ensure STS2_MCP.dll and .json are in the /mods/ directory and mods are enabled in game settings.

STS2MCP MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

Real-time game state exposure via REST API and MCP server
Autonomous AI gameplay — let Claude play full runs of STS2
Beta co-op mode for collaborative AI-human gameplay
Cross-platform: Windows, Linux, and macOS
Simple mod installation: drop DLL into mods folder

实时演示

实际使用效果

sts2mcp-2.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sts2mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Gennadiyev/STS2MCP"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sts2mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Gennadiyev/STS2MCP"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sts2mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Gennadiyev/STS2MCP"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sts2mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/Gennadiyev/STS2MCP"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sts2mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/Gennadiyev/STS2MCP"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "sts2mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/Gennadiyev/STS2MCP"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add sts2mcp-2 -- TODO 'See README: https://github.com/Gennadiyev/STS2MCP'

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： STS2MCP

How to have Claude play a run of Slay the Spire 2

👤 STS2 players curious about AI strategy ⏱ ~60 min beginner

何时使用： You want to see how an AI approaches deck building and combat decisions.

前置条件

STS2 with the mod installed — Download STS2_MCP.dll and .json to <game>/mods/, enable mods in settings
MCP server running — Server auto-starts on localhost:15526 when mod loads

步骤

Start a run

Start a new Slay the Spire 2 run. Check the game state — what character are we playing and what's our starting deck?✓ 已复制

→ Character info, starting deck, and current map
Make strategic decisions

We're at a card reward screen. Analyze the options based on our current deck and suggest the best pick.✓ 已复制

→ Analysis of each option with recommendation
Handle combat

We're in combat. Show me our hand, the enemies, and their intents. What's the optimal play order?✓ 已复制

→ Combat analysis with recommended card play sequence

结果： A complete STS2 run with AI making strategic decisions.

注意事项

AI makes suboptimal decisions without full game knowledge — Provide context about game mechanics and synergies the AI may not know

组合

与其他 MCP 搭配，撬动十倍杠杆

sts2mcp-2 + filesystem

Log game states and decisions for analysis and strategy improvement

Log every decision point and our choice to ~/sts2/run-log.json for later analysis.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用	成本
get_game_state	none	Get the current game state (map, deck, health, combat, etc.)	0
execute_action	action: str, params?: obj	Execute a game action (play card, end turn, make a choice)	0

成本与限制

运行它的成本

API 配额: N/A — fully local
每次调用 Token 数: 200–1000 tokens per game state query
费用: Free mod — requires Slay the Spire 2 ($24.99)
提示: Query game state only at decision points, not every frame.

安全

权限、密钥、影响范围

凭据存储： N/A

数据出站： Local only — REST API on localhost:15526

故障排查

常见错误与修复

Mod not loading

Ensure STS2_MCP.dll and .json are in the <game>/mods/ directory and mods are enabled in game settings.

验证： Check the game's mod manager for STS2MCP

Can't connect to API

The server starts on localhost:15526 when the mod loads. Ensure the game is running with the mod enabled.

验证： curl http://localhost:15526/state

Game state returns empty during loading screens

Wait until the game finishes loading. State is only available during active gameplay.

验证： Try again after the map or combat screen is visible

替代方案

STS2MCP 对比其他方案

替代方案	何时用它替代	权衡
Minecraft MCP Server	You want AI-controlled gameplay in Minecraft rather than a card game	Different genre — open world building vs strategic card game

STS2MCP