[Модельный контекстный протокол] mcp (MCP) сервер для опубликованного API данных Chess.com.

Это обеспечивает доступ к данным игроков Chess.com, игровым записям и другой публичной информации через стандартизированные интерфейсы MCP, позволяя помощникам ИИ искать и анализировать шахматную информацию.

[[Т0]]

Особенности

• [x] Профили игроков доступа, статистика и игровые записи
• [x] Поиск игр по дате и игроку [x] Проверьте статус игрока в Интернете
• [x] Получите информацию о клубах и титулованных игроках
• [x] Не требуется аутентификация (используется общедоступный API Chess.com)
• [x] Поддержка контейнеров Docker
• [x] Предоставить интерактивные инструменты для помощников ИИ

Список инструментов настраивается, поэтому вы можете выбрать, какие инструменты вы хотите сделать доступными для клиента MCP.

Использование

###Докер (рекомендуется)

Самый простой способ запускать шахматы с помощью Claude Desktop — это Docker. Если у вас нет Docker, вы можете получить его с официального сайта Docker.

Отредактируйте файл конфигурации Claude Desktop: Mac: ~/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