Servidor Mcp do Chess.com

O que é o Chess MCP?

O Chess MCP é um servidor do Modelo Context Protocol projetado para interagir com a API de Dados Publicados do Chess.com. Ele fornece uma maneira padronizada de acessar uma riqueza de dados relacionados ao xadrez, incluindo estatísticas de jogadores, registros de jogos e outras informações públicas. Isso permite que desenvolvedores e assistentes de IA pesquisem e analisem informações sobre xadrez de forma eficiente, facilitando a construção de aplicativos e ferramentas que utilizam dados de xadrez.

Recursos do Chess MCP

• Interfaces Padronizadas: O Chess MCP utiliza interfaces padronizadas do Modelo Context Protocol, garantindo acesso consistente aos dados em diferentes aplicativos.
• Acesso Abrangente a Dados: Os usuários podem recuperar dados detalhados de jogadores, incluindo classificações, histórico de jogos e métricas de desempenho.
• Integração com IA: O protocolo é projetado para facilitar a integração de assistentes de IA, permitindo que eles analisem informações de xadrez e forneçam insights.
• Informações Públicas: Todos os dados acessados através do Chess MCP estão disponíveis publicamente, garantindo transparência e acessibilidade para desenvolvedores e usuários.
• Código Aberto: O Chess MCP é um projeto de código aberto, permitindo que desenvolvedores contribuam, modifiquem e aprimorem o protocolo conforme necessário.

Como Usar o Chess MCP

1. Configurar o Ambiente: Certifique-se de ter as ferramentas e bibliotecas necessárias instaladas para interagir com a API do Chess.com.
2. Acessar a API: Use as interfaces padronizadas do MCP para se conectar aos dados do Chess.com. Isso geralmente envolve fazer solicitações HTTP para os endpoints da API.
3. Recuperar Dados: Utilize os vários endpoints para buscar dados de jogadores, registros de jogos e outras informações relevantes.
4. Analisar Dados: Implemente lógica em seu aplicativo para analisar os dados recuperados, seja para uso pessoal, treinamento de IA ou outros propósitos.
5. Contribuir para o Projeto: Se você tiver melhorias ou recursos para adicionar, considere contribuir para o repositório do Chess MCP no GitHub.

Perguntas Frequentes

Q: Que tipo de dados posso acessar com o Chess MCP?

A: Você pode acessar uma variedade de dados relacionados ao xadrez, incluindo perfis de jogadores, históricos de jogos e estatísticas do Chess.com.

Q: O Chess MCP é gratuito para usar?

A: Sim, o Chess MCP é um projeto de código aberto, e todos os dados acessados através dele estão disponíveis publicamente.

Q: Posso integrar o Chess MCP com aplicativos de IA?

A: Absolutamente! O Chess MCP é projetado para facilitar a integração de IA, permitindo que assistentes de IA analisem e forneçam insights com base em dados de xadrez.

Q: Como posso contribuir para o Chess MCP?

A: Você pode contribuir fazendo um fork do repositório no GitHub, fazendo suas alterações e enviando um pull request para revisão.

Q: Onde posso encontrar a documentação do Chess MCP?

A: A documentação geralmente está disponível no arquivo README do repositório ou em uma seção dedicada à documentação dentro do projeto.

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