War Thunder Replay MCP

War Thunder 서버 리플레이의 모든 .wrpl 조각을 내려받는 독립 로컬 MCP 서버입니다.

USER_ID로 리플레이를 검색하고 정확한 SESSION_ID를 찾은 뒤, War Thunder 리플레이 API에서 메타데이터를 읽어 세션별 폴더에 병렬로 다운로드합니다.

요구 사항

• Python 3.13

• uv

• warthunder.com에 로그인된 Microsoft Edge

Edge 쿠키를 사용할 수 없는 환경에서는 WARTHUNDER_LOGIN_COOKIE 환경변수에 쿠키 문자열을 설정할 수 있습니다. 쿠키 값은 MCP 도구의 인자나 결과에 노출되지 않습니다.

Related MCP server: peek

설치 및 검증

cd <warthunder-replay-mcp-directory>
uv sync
uv run pytest
uv run ruff check .

MCP 서버 실행

uv run warthunder-replay-mcp

서버는 로컬 MCP 클라이언트용 stdio 전송을 사용합니다. stdout은 MCP 메시지 전용이며 다운로드 진행 상황은 stderr에 출력됩니다.

제공 도구:

• get_mcp_status: 저장 위치와 인증 방식을 확인합니다.

• download_replay: user_id, session_id, max_workers를 받아 리플레이를 다운로드합니다.

파일은 항상 WARTHUNDER_REPLAY_DOWNLOAD_ROOT\<session_id>\ 아래에 저장됩니다. 환경변수를 생략하면 현재 작업 폴더의 Downloads\<session_id>\를 사용합니다.

MCP 클라이언트 설정 예시

[mcp_servers.warthunder_replay]
command = "C:\\path\\to\\warthunder-replay-mcp\\.venv\\Scripts\\warthunder-replay-mcp.exe"
cwd = "C:\\path\\to\\warthunder-replay-mcp"

[mcp_servers.warthunder_replay.env]
WARTHUNDER_REPLAY_DOWNLOAD_ROOT = "C:\\path\\to\\replay-downloads"

인증 참고 사항

• 기본값은 browser-cookie3를 이용한 Microsoft Edge 쿠키 자동 로드입니다.

• Edge가 실행 중이거나 Windows 보안 정책이 쿠키 복호화를 막으면 자동 로드가 실패할 수 있습니다.

• 이때 WARTHUNDER_LOGIN_COOKIE를 MCP 서버 프로세스 환경에만 설정하세요.

• 높은 동시 다운로드 수는 연결 초기화를 늘릴 수 있어 2~3개부터 권장합니다.

프로젝트 구조

src/warthunder_replay_mcp/
  cli.py
  config.py
  downloader.py
  server.py
tests/

docs/, scripts/, examples/는 로컬 보조 자료로 기본 .gitignore 대상입니다.