도구

STS2 MCP —— AI 자동 플레이 설정 가이드

STS2 MCP mod를 설치하고 Claude나 임의의 MCP 에이전트를 연결해 슬레이 더 스파이어 2를 완전 자동으로 플레이하세요.

Mod v0.3.4 · STS2 v0.103.2에서 테스트 · MIT 라이선스 · Windows / macOS / Linux

STS2 MCP란?

STS2 MCP는 슬레이 더 스파이어 2의 게임 상태와 조작을 localhost REST API로 노출하고, 선택적 MCP 서버까지 제공하는 커뮤니티 mod입니다. AI 에이전트를 연결하면 모델이 보드를 읽고 스스로 런을 완주할 수 있습니다 —— STS2 런을 완전 자동화하는 실험적 프로젝트입니다.

  • 싱글플레이와 협동(co-op) 모두 완전 자동화. 메뉴, 로비, 캐릭터 선택까지 포함
  • localhost:15526의 HTTP로 실시간 게임 상태 조회
  • 프로필 진행도, 도감(compendium), 해금된 카드/유물의 퍼지 wiki 검색
  • Claude Code, Claude Desktop, 또는 임의의 커스텀 MCP 클라이언트와 호환

요구 사항

슬레이 더 스파이어 2 본편(v0.103.2에서 테스트)

Python 3.11+와 uv 패키지 매니저(MCP 서버에만 필요)

Claude Code, Claude Desktop, 또는 MCP를 지원하는 다른 클라이언트

1단계 —— Mod 설치

Mod는 DLL 하나와 매니페스트뿐입니다. 둘 다 게임의 mods 폴더에 넣으면 HTTP 서버가 자동으로 시작됩니다.

  1. 1

    GitHub 저장소에서 최신 릴리스를 다운로드합니다.

  2. 2

    STS2_MCP.dll과 STS2_MCP.json을 [게임 설치 경로]/mods/에 복사합니다.다운로드

  3. 3

    게임을 실행하고 설정에서 mods를 활성화합니다.

  4. 4

    HTTP 서버가 localhost:15526에서 자동으로 시작됩니다.

macOS 설치 경로

macOS에서는 mods 폴더가 app bundle 내부에 있습니다. 아래 명령으로 폴더를 만들고 파일을 복사하세요.

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

설치 확인

게임이 실행 중일 때 루트 엔드포인트에 접속합니다. 정상 설치라면 버전 인사말이 반환됩니다.

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

2단계 —— AI 연결

선택적 MCP 서버를 통해 Claude가 도구 호출로 mod와 통신합니다. Python 3.11+와 uv가 필요합니다.

이 블록을 Claude Code의 .mcp.json 또는 Claude Desktop의 claude_desktop_config.json에 추가하고, directory를 로컬 체크아웃 경로로 지정하세요.

{
  "mcpServers": {
    "sts2": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/STS2MCP/mcp", "python", "server.py"]
    }
  }
}
macOS에서는 command 필드에 uv의 절대 경로(예: /opt/homebrew/bin/uv)를 사용하세요. 그렇지 않으면 Claude가 찾지 못할 수 있습니다.

선택 플래그

  • --host와 --port: 기본값이 아닌 주소에서 실행.
  • --no-trust-env: 프록시 환경 변수 무시.
설정을 수정한 뒤 Claude를 재시작하고, get_game_state를 실행하게 해 연결을 확인하세요.

API 및 MCP 도구 레퍼런스

직접 에이전트를 만든다면 이것들이 mod가 노출하는 인터페이스입니다. REST 엔드포인트는 직접 접근 가능하며, MCP 서버는 이를 도구로 래핑합니다.

REST 엔드포인트

GET /api/v1/profile활성 프로필의 영구 진행 요약.
GET /api/v1/compendium상위 진행도: 카드 라이브러리, 유물, 물약, 도감, 캐릭터 통계, 런 기록.
GET /api/v1/wiki?query=...해금된 카드와 유물에 대한 퍼지 검색(기본 10개, limit로 재정의).
GET /api/v1/profiles세 개의 프로필 슬롯과 활성 프로필을 나열.
POST /api/v1/profiles프로필 슬롯 전환 또는 삭제.

MCP 서버 도구

get_game_state()현재 게임 상태.
get_profile()활성 프로필 데이터.
get_compendium()메인 메뉴 또는 진행 중인 런의 지속 컨텍스트.
search_wiki(query, item_type, limit)카드 또는 유물 선택 조회.
list_profiles()프로필 슬롯 나열.
switch_profile(profile_id)활성 프로필 전환.
delete_profile(profile_id)프로필 슬롯 삭제.

토큰 비용

완전 자동 플레이는 토큰을 많이 씁니다: Claude Sonnet 4.6으로 아이언클래드(Ironclad) 한 런을 완주하면 약 800만 토큰(입력·출력·도구 응답 합산), GPT-5.4는 약 734만입니다. 에이전트에게 승천을 반복시키기 전에 API 예산을 계획하세요.

STS2 MCP는 Gennadiyev의 오픈소스 프로젝트로 MIT 라이선스로 공개되었습니다. 릴리스, 소스, 이슈는 저장소를 참고하세요.

GitHub에서 보기