Chess.com MCP Server

Chess.com MCP 服务

一个用于 Chess.com Published Data API 的 Model Context Protocol（MCP）服务。

该服务通过标准化的 MCP 接口提供 Chess.com 玩家数据、对局记录及其他公开信息的访问能力，让 AI 助手能够搜索和分析国际象棋信息。

https://github.com/user-attachments/assets/3b33361b-b604-465c-9f6a-3699b6907757

功能

• 访问玩家个人资料、统计数据和对局记录
• 按日期和玩家搜索对局
• 查看玩家的在线状态
• 获取俱乐部和特级大师等称号玩家的信息
• 无需身份验证（使用 Chess.com 的公共 API）
• 支持 Docker 容器化
• 为 AI 助手提供交互式工具

工具列表可配置，因此你可以选择要向 MCP 客户端提供哪些工具。

用法

Docker（推荐）

使用 Docker 运行 chess-mcp 并与 Claude Desktop 搭配使用，是最简单的方法。如果尚未安装 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。

开发

欢迎贡献！如果你有任何建议或改进，请提交问题或拉取请求。

本项目使用 uv 管理依赖项。请按照适用于你平台的说明安装 uv：

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

然后，你可以创建虚拟环境并安装依赖项：

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

测试

本项目包含测试套件，可确保功能正常并帮助防止回归问题。

使用 pytest 运行测试：

# Install development dependencies
uv pip install -e ".[dev]"

# Run the tests
pytest

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

可用工具

玩家信息

• get_player_profile - 获取玩家在 Chess.com 的个人资料
• get_player_stats - 获取玩家在 Chess.com 的统计数据
• is_player_online - 检查玩家当前是否在线 Chess.com
• get_titled_players - 获取 Chess.com 上获得称号的玩家列表

对局

• get_player_current_games - 获取玩家在 Chess.com 上正在进行的对局
• get_player_games_by_month - 获取玩家在 Chess.com 上特定月份的对局
• get_player_game_archives - 获取玩家在 Chess.com 上可用的按月对局存档列表
• download_player_games_pgn - 下载 Chess.com 上特定月份内所有对局的 PGN 文件

俱乐部

• get_club_profile - 获取 Chess.com 上某个俱乐部的信息
• get_club_members - 获取 Chess.com 上某个俱乐部的成员

许可证

MIT

---