Chess.com MCP 서버

Chess.com의 게시된 데이터 API를 위한 모델 컨텍스트 프로토콜 (MCP) 서버입니다.

이를 통해 표준화된 MCP 인터페이스를 통해 Chess.com 플레이어 데이터, 게임 기록 및 기타 공개 정보에 액세스할 수 있으므로 AI 보조원이 체스 정보를 검색하고 분석할 수 있습니다.

https://github.com/user-attachments/assets/3b33361b-b604-465c-9f6a-3699b6907757

특징

• [x] 플레이어 프로필, 통계 및 게임 기록에 액세스합니다.

• [x] 날짜 및 플레이어로 게임 검색

• [x] 플레이어 온라인 상태 확인

• [x] 클럽 및 타이틀 플레이어에 대한 정보를 얻으세요

• [x] 인증 필요 없음(Chess.com의 공개 API 사용)

• [x] Docker 컨테이너화 지원

• [x] AI 어시스턴트를 위한 대화형 도구 제공

도구 목록은 구성 가능하므로 MCP 클라이언트에서 사용할 도구를 선택할 수 있습니다.

Related MCP server: Chess.com MCP Server

용법

Docker(추천)

Claude Desktop 으로 chess-mcp를 실행하는 가장 쉬운 방법은 Docker를 사용하는 것입니다. Docker가 설치되어 있지 않다면 Docker 공식 웹사이트 에서 다운로드할 수 있습니다.

Claude Desktop 구성 파일을 편집하세요.

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

• 윈도우: %APPDATA%/Claude/claude_desktop_config.json

• 리눅스: ~/.config/Claude/claude_desktop_config.json

그런 다음 다음 구성을 추가합니다.

지엑스피1

UV로 달리기

또는 UV를 사용하여 서버를 직접 실행할 수 있습니다. Claude Desktop 설정 파일(위에 나열된 위치)을 편집하고 서버 구성을 추가하세요.

{
  "mcpServers": {
    "chess": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to chess-mcp directory>",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

참고: Claude Desktop 에서 Error: spawn uv ENOENT 표시되면 uv 에 대한 전체 경로를 지정하거나 구성에서 환경 변수 NO_UV=1 설정해야 할 수 있습니다.

개발

기여를 환영합니다! 제안이나 개선 사항이 있으시면 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.

이 프로젝트는 uv 사용하여 종속성을 관리합니다. 플랫폼에 맞는 지침에 따라 uv 설치하세요.

curl -LsSf https://astral.sh/uv/install.sh | sh

그런 다음 가상 환경을 만들고 다음을 사용하여 종속성을 설치할 수 있습니다.

uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows
uv pip install -e .

테스트

이 프로젝트에는 기능성을 보장하고 회귀를 방지하는 데 도움이 되는 테스트 모음이 포함되어 있습니다.

pytest로 테스트를 실행합니다.

# Install development dependencies
uv pip install -e ".[dev]"

# Run the tests
pytest

# Run with coverage report
pytest --cov=src --cov-report=term-missing

사용 가능한 도구

플레이어 정보

• get_player_profile - Chess.com에서 플레이어 프로필을 가져옵니다.

• get_player_stats - Chess.com에서 플레이어의 통계를 가져옵니다.

• is_player_online - 플레이어가 현재 Chess.com에 온라인 상태인지 확인합니다.

• get_titled_players - Chess.com에서 타이틀을 획득한 플레이어 목록을 가져옵니다.

계략

• get_player_current_games - Chess.com에서 플레이어의 진행 중인 게임을 받아보세요

• get_player_games_by_month - Chess.com에서 특정 월의 플레이어 게임을 받아보세요

• get_player_game_archives - Chess.com에서 플레이어의 월별 게임 아카이브 목록을 가져옵니다.

• download_player_games_pgn - Chess.com에서 특정 월의 모든 게임에 대한 PGN 파일을 다운로드하세요

클럽

• get_club_profile - Chess.com에서 클럽에 대한 정보를 얻으세요

• get_club_members - Chess.com에서 클럽 회원을 모집합니다

특허

MIT