Chess.com MCP сервер

Что такое Chess MCP?

Chess MCP — это сервер Model Context Protocol, предназначенный для взаимодействия с опубликованным API данных Chess.com. Он предоставляет стандартизированный способ доступа к большому объему данных, связанных с шахматами, включая статистику игроков, записи игр и другую общедоступную информацию. Это позволяет разработчикам и AI-ассистентам эффективно искать и анализировать шахматную информацию, упрощая создание приложений и инструментов, использующих шахматные данные.

Особенности Chess MCP

• Стандартизированные интерфейсы: Chess MCP использует стандартизированные интерфейсы Model Context Protocol, обеспечивая последовательный доступ к данным в различных приложениях.
• Комплексный доступ к данным: Пользователи могут получать подробные данные о игроках, включая рейтинги, историю игр и показатели производительности.
• Интеграция AI: Протокол разработан для упрощения интеграции AI-ассистентов, позволяя им анализировать шахматную информацию и предоставлять инсайты.
• Общедоступная информация: Все данные, доступные через Chess MCP, являются общедоступными, что обеспечивает прозрачность и доступность для разработчиков и пользователей.
• Открытый исходный код: Chess MCP — это проект с открытым исходным кодом, позволяющий разработчикам вносить свой вклад, модифицировать и улучшать протокол по мере необходимости.

Как использовать Chess MCP

1. Настройте окружение: Убедитесь, что у вас установлены необходимые инструменты и библиотеки для взаимодействия с API Chess.com.
2. Получите доступ к API: Используйте стандартизированные интерфейсы MCP для подключения к данным Chess.com. Обычно это включает в себя выполнение HTTP-запросов к конечным точкам API.
3. Извлеките данные: Используйте различные конечные точки для получения данных о игроках, записях игр и другой соответствующей информации.
4. Анализируйте данные: Реализуйте логику в вашем приложении для анализа извлеченных данных, будь то для личного использования, обучения AI или других целей.
5. Внесите вклад в проект: Если у вас есть улучшения или функции для добавления, рассмотрите возможность внесения вклада в репозиторий Chess MCP на GitHub.

Часто задаваемые вопросы

В: Какой тип данных я могу получить с помощью Chess MCP?

О: Вы можете получить доступ к различным данным, связанным с шахматами, включая профили игроков, истории игр и статистику с Chess.com.

В: Бесплатен ли Chess MCP для использования?

О: Да, Chess MCP — это проект с открытым исходным кодом, и все данные, доступные через него, являются общедоступными.

В: Могу ли я интегрировать Chess MCP с AI-приложениями?

О: Абсолютно! Chess MCP разработан для упрощения интеграции AI, позволяя AI-ассистентам анализировать и предоставлять инсайты на основе шахматных данных.

В: Как я могу внести вклад в Chess MCP?

О: Вы можете внести вклад, сделав форк репозитория на GitHub, внеся свои изменения и отправив запрос на слияние для рассмотрения.

В: Где я могу найти документацию для Chess MCP?

О: Документация обычно доступна в файле README репозитория или в отдельном разделе документации в проекте.

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

• Access player profiles, stats, and game records
• Search games by date and player
• Check player online status
• Get information about clubs and titled players
• No authentication required (uses Chess.com's public API)
• Docker containerization support
• 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",
        "<full path to chess-mcp 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

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

Available Tools

Player Information

• get_player_profile - Get a player's profile from Chess.com
• get_player_stats - Get a player's stats from Chess.com
• is_player_online - Check if a player is currently online on Chess.com
• get_titled_players - Get a list of titled players from Chess.com

Games

• get_player_current_games - Get a player's ongoing games on Chess.com
• get_player_games_by_month - Get a player's games for a specific month from Chess.com
• get_player_game_archives - Get a list of available monthly game archives for a player on Chess.com
• download_player_games_pgn - Download PGN files for all games in a specific month from Chess.com

Clubs

• get_club_profile - Get information about a club on Chess.com
• get_club_members - Get members of a club on Chess.com

License

MIT