🚀 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: 获取具有特定头衔的玩家列表。

每个工具都有详细的文档和示例，帮助您轻松集成到项目中。