Chess.com Mcp 伺服器

什麼是 Chess MCP？

Chess MCP 是一個模型上下文協議伺服器，旨在與 Chess.com 的公開數據 API 進行接口。它提供了一種標準化的方式來訪問大量與棋類相關的數據，包括玩家統計、比賽記錄和其他公共信息。這使得開發者和 AI 助手能夠高效地搜索和分析棋類信息，從而更容易構建利用棋類數據的應用程序和工具。

Chess MCP 的特點

• 標準化接口：Chess MCP 利用標準化的模型上下文協議接口，確保不同應用程序之間對數據的一致訪問。
• 全面數據訪問：用戶可以檢索詳細的玩家數據，包括排名、比賽歷史和表現指標。
• AI 集成：該協議旨在促進 AI 助手的集成，使其能夠分析棋類信息並提供見解。
• 公共信息：通過 Chess MCP 訪問的所有數據都是公開可用的，確保開發者和用戶的透明性和可訪問性。
• 開源：Chess MCP 是一個開源項目，允許開發者根據需要貢獻、修改和增強該協議。

如何使用 Chess MCP

1. 設置環境：確保您已安裝必要的工具和庫，以便與 Chess.com API 進行交互。
2. 訪問 API：使用標準化的 MCP 接口連接到 Chess.com 數據。這通常涉及向 API 端點發送 HTTP 請求。
3. 檢索數據：利用各種端點來獲取玩家數據、比賽記錄和其他相關信息。
4. 分析數據：在您的應用程序中實施邏輯以分析檢索到的數據，無論是用於個人使用、AI 訓練還是其他目的。
5. 貢獻項目：如果您有改進或功能要添加，考慮向 GitHub 上的 Chess MCP 存儲庫貢獻。

常見問題

問：我可以使用 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