remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to Chess.com player data, profiles, statistics, game records, online status checks, club information, and titled player lists through Chess.com's Published Data API.

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 클라이언트에서 사용할 도구를 선택할 수 있습니다.

용법

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

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

Appeared in Searches

A search for games