STS2 MCP —— AI 자동 플레이 설정 가이드
STS2 MCP mod를 설치하고 Claude나 임의의 MCP 에이전트를 연결해 슬레이 더 스파이어 2를 완전 자동으로 플레이하세요.
Mod v0.3.4 · STS2 v0.103.2에서 테스트 · MIT 라이선스 · Windows / macOS / LinuxSTS2 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
GitHub 저장소에서 최신 릴리스를 다운로드합니다.
- 2
STS2_MCP.dll과 STS2_MCP.json을 [게임 설치 경로]/mods/에 복사합니다.다운로드
- 3
게임을 실행하고 설정에서 mods를 활성화합니다.
- 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"]
}
}
}선택 플래그
- --host와 --port: 기본값이 아닌 주소에서 실행.
- --no-trust-env: 프록시 환경 변수 무시.
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에서 보기