Chess MCP

🚀 Chess.com MCP 服務器

Chess.com MCP 服務器是一個基於 模型上下文協議 (MCP) 的服務器，它為 Chess.com 的數據 API 提供服務。藉助標準化的 MCP 接口，該服務器能夠訪問 Chess.com 上的玩家數據、遊戲記錄等公開信息，方便 AI 助手對國際象棋信息進行搜索和分析。

鏈接

🚀 快速開始

本服務器為您提供了便捷的使用方式，您可以根據自身需求選擇 Docker 或者直接使用 UV 來運行服務器。

✨ 主要特性

• [x] 可訪問玩家個人資料、統計信息和遊戲記錄。
• [x] 支持按日期和玩家搜索遊戲。
• [x] 能夠檢查玩家在線狀態。
• [x] 可獲取俱樂部和頭銜玩家的信息。
• [x] 無需身份驗證，使用 Chess.com 的公共 API。
• [x] 支持 Docker 容器化。
• [x] 提供交互式工具，供 AI 助手使用。

工具列表是可配置的，您可以根據實際需求選擇要提供給 MCP 客戶端的工具。

📦 安裝指南

Docker（推薦）

使用 Claude Desktop 運行 chess-mcp 的最簡單方法是通過 Docker。如果您還沒有安裝 Docker，請從 Docker 官方網站 下載並安裝。

編輯您的 Claude Desktop 配置文件：

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

然後添加以下配置：

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

直接使用 UV

您也可以直接使用 UV 運行服務器。編輯您的 Claude Desktop 配置文件（位置如上所述），並添加以下服務器配置：

{
  "mcpServers": {
    "chess": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to chess-mcp directory>",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

⚠️ 重要提示

如果在 Claude Desktop 中看到 Error: spawn uv ENOENT，您可能需要指定 UV 的完整路徑或在配置中設置環境變量 NO_UV=1。

💻 使用示例

基礎用法

以下是在配置文件中添加服務器配置的示例：

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

高級用法

若要直接使用 UV 運行服務器，可在配置文件中添加如下配置：

{
  "mcpServers": {
    "chess": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to chess-mcp directory>",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

📚 詳細文檔

開發

歡迎您為項目貢獻代碼！如果您有任何建議或改進，請打開問題或提交拉取請求。

該項目使用 uv 管理依賴項。按照平臺說明安裝 uv：

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

然後創建虛擬環境並安裝依賴項：

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

測試

該項目包含一個測試套件，可確保功能正常並防止出現迴歸問題。

運行測試：

npm test

工具

以下是 MCP 服務器支持的工具列表：

• get_player_profile: 獲取玩家個人資料信息。
• search_games_by_date: 按日期搜索遊戲記錄。
• check_online_status: 檢查玩家在線狀態。
• get_club_info: 獲取俱樂部詳細信息。
• retrieve_titled_players: 獲取具有特定頭銜的玩家列表。

每個工具都有詳細的文檔和示例，幫助您輕鬆集成到項目中。