faceit-mcp

Claude에게 실시간 CS2 FACEIT 데이터(플레이어 통계, 매치 기록, 나란히 비교, 리더보드, ELO 추이)를 제공하는 독립형 MCP 서버입니다.

Claude Desktop 및 Claude Code와 함께 작동합니다. mcp, aiohttp, aiosqlite, python-dotenv 외에는 프레임워크 의존성이 없는 단일 파일 구성입니다.

데모

사용자: zywoo, NiKo, sh1ro를 나란히 비교해줘

Claude: 세 플레이어의 비교 결과입니다:

	ZywOo	NiKo	sh1ro
ELO	4521	4218	4384
레벨	10	10	10
K/D	1.43	1.38	1.41
헤드샷%	52.1%	48.7%	44.2%
승률	61.3%	58.9%	60.1%
평균 킬	24.8	23.6	23.1
K/R	0.91	0.87	0.89

사용자: NiKo의 최근 20경기 성적은 어때?

Claude: NiKo의 최근 20경기 성적:

• 전적: 13승 7패 (승률 65.0%)

• 평균 K/D: 1.42 | 평균 킬: 24.3 | 평균 헤드샷%: 49.1%

• 현재 연승: 3연승

최고의 맵: de_inferno (8승 2패, 승률 70%), de_ancient (4승 1패, 승률 80%) 최악의 맵: de_vertigo (1승 3패, 승률 25%)

Related MCP server: Claude Stats MCP

도구

get_leaderboard와 get_elo_trend를 제외한 모든 도구는 API 키만 있으면 모든 공개 FACEIT 플레이어에 대해 작동합니다. 리더보드 및 ELO 추이 도구는 등록된 사용자가 포함된 SQLite DB가 필요합니다(DB 설정 참조).

요구 사항

• Python 3.12+

• FACEIT Data API 키 (무료)

설정

1. 복제 및 의존성 설치

git clone https://github.com/bluemadisonblue/faceit-mcp.git
cd faceit-mcp
pip install -r requirements.txt

2. API 키 설정

스크립트 옆에 .env 파일을 생성하세요:

FACEIT_API_KEY=your_key_here

또는 아래 설정에서 환경 변수로 직접 전달하세요.

Claude Desktop에 연결

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "faceit-cs2": {
      "command": "python",
      "args": ["C:/full/path/to/faceit-mcp/faceit_mcp_server.py"],
      "env": { "FACEIT_API_KEY": "your_key_here" }
    }
  }
}

설정 파일 위치:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code에 연결

claude mcp add faceit-cs2 -- python /full/path/to/faceit-mcp/faceit_mcp_server.py

그런 다음 스크립트 옆의 .env 파일에 FACEIT_API_KEY를 설정하세요.

프롬프트 예시

연결 후, Claude에게 자연스럽게 물어보세요:

• "s1mple의 통산 통계가 뭐야?"

• "NiKo의 최근 10경기 보여줘"

• "zywoo, device, sh1ro를 나란히 비교해줘"

• "NiKo의 최근 20경기 성적은 어때?"

• "매치 1-abc123…의 전체 스코어보드를 보여줘"

• "sh1ro가 가장 잘하는 맵은 뭐야?"

• "우리 그룹의 리더보드를 보여줘"

• "지난 한 달 동안 내 ELO는 어떻게 변했어?"

리더보드 및 ELO 추이

get_leaderboard와 get_elo_trend는 로컬 SQLite 데이터베이스에서 읽어옵니다. 기본적으로 DB는 ~/.faceit-mcp/data.db에 위치하며 시작 시 자동으로 생성됩니다.

데이터를 채우려면 DB_PATH를 users 테이블이 있는 데이터베이스로 지정하세요:

DB_PATH=/path/to/your/bot_data.db

CS2 FACEIT 텔레그램 봇을 함께 사용하는 경우, DB_PATH를 해당 봇의 데이터베이스로 설정하면 등록된 사용자가 자동으로 반영됩니다.

환경 변수

라이선스

MIT