Gennadiyev/STS2MCP

해결하는 문제

STS2MCP는 복잡한 덱 빌딩 게임인 Slay the Spire 2 를 AI 에이전트가 플레이할 수 있도록 해줍니다. 게임의 내부 상태와 사용 가능한 행동을 AI가 이해하고 실행할 수 있는 형식으로 변환함으로써, 시각 기반 GUI 에이전트에 의존하는 불안정한 접근 방식을 제거합니다.

작동 방식

이 프로젝트는 게임에 로컬호스트 REST API를 삽입하는 게임 모드로 구성되어 있습니다. 이 API는 현재 게임 상태, 플레이어 프로필, 카드 및 유물에 대한 검색 가능한 위키를 노출합니다. AI 클라이언트가 사용하기 쉽게 하기 위해, 선택적으로 Model Context Protocol (MCP) 서버도 포함되어 있으며, 게임의 API와 AI 에이전트(예: Claude Desktop 또는 Claude Code) 사이를 연결하는 다리 역할을 합니다. 이를 통해 에이전트는 get_game_state 와 같은 도구를 호출하여 결정을 내릴 수 있습니다.

대상 사용자

• AI 연구자: 복잡하고 "분포 외"의 게임 도메인에서 LLM의 추론 및 의사결정 능력을 테스트하고자 하는 분들.
• AI 에이전트 개발자: 픽셀이 아닌 API를 통해 소프트웨어와 상호작용할 수 있는 에이전트를 개발하고자 하는 분들.
• 플레이어: AI와 협동 플레이를 실험하거나 게임의 반복 작업을 자동화하고 싶은 분들.

주요 특징

• 완전한 게임 제어: 싱글플레이 및 멀티플레이(협동 플레이) 실행을 지원하며, 메뉴 탐색, 캐릭터 선택, 룸 관리까지 가능합니다.
• 지속적인 컨텍스트: 활성 프로필의 컴패니언, 런 기록, 발견된 아이템에 대한 퍼지 검색 가능한 위키에 접근 가능합니다.
• 크로스 플랫폼: Windows, Linux, macOS에서 동작하는 .NET 어셈블리로 구현되어 있습니다.
• MCP 통합: Model Context Protocol에 네이티브로 통합되어, 호환되는 AI 클라이언트와 즉시 연결 가능합니다.