A Model Context Protocol (MCP) Chess.com의 게시 데이터 API에 대한 서버.

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

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

특징

• [x] Access Player 프로파일, 통계 및 게임 레코드
• [x] 날짜 및 플레이어로 게임 검색
• [x] 온라인 상태 확인
• [x] 클럽 및 타이틀 플레이어에 대한 정보를 얻으십시오
• [x] 인증 필요 없음 (Chs.com의 공개 API 사용)
• [x] Docker 컨테이너화 지원
• [x] AI Assistant를 위한 대화형 도구 제공

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

사용법

Docker (추천)

Claude 데스크톱과 함께 체스-mcp를 실행하는 가장 쉬운 방법은 Docker를 사용합니다. Docker가 설치되어 있지 않은 경우 Docker의 공식 웹 사이트에서 얻을 수 있습니다.

Claude Desktop config 파일 편집:

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

Chess.com MCP Server

A Model Context Protocol (MCP) server for Chess.com’s Published Data API.

This provides access to Chess.com player data, game records, and other public information through standardized MCP interfaces, allowing AI assistants to search and analyze chess information.

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

Features

• [x] Access player profiles, stats, and game records
• [x] Search games by date and player
• [x] Check player online status
• [x] Get information about clubs and titled players
• [x] No authentication required (uses Chess.com’s public API)
• [x] Docker containerization support
• [x] Provide interactive tools for AI assistants

The list of tools is configurable, so you can choose which tools you want to make available to the MCP client.

Usage

Docker (Recommended)

The easiest way to run chess-mcp with Claude Desktop is using Docker. If you don’t have Docker installed, you can get it from Docker’s official website.

Edit your Claude Desktop config file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Then add the following configuration:

{
  "mcpServers": {
    "chess": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "pab1it0/chess-mcp"
      ]
    }
  }
}

Running with UV

Alternatively, you can run the server directly using UV. Edit your Claude Desktop config file (locations listed above) and add the server configuration:

{
  "mcpServers": {
    "chess": {
      "command": "uv",
      "args": [
        "--directory",
        "",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

Note: if you see Error: spawn uv ENOENT in Claude Desktop, you may need to specify the full path to uv or set the environment variable NO_UV=1 in the configuration.

Development

Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.

This project uses uv to manage dependencies. Install uv following the instructions for your platform:

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

You can then create a virtual environment and install the dependencies with:

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

Testing

The project includes a test suite that ensures functionality and helps prevent regressions.

Run the tests with pytest:

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

# Run the tests
pytest