Chess.com MCP 服务器

一个用于 Chess.com 发布数据 API 的 模型上下文协议 (MCP) 服务器。

它通过标准化的 MCP 接口提供对 Chess.com 玩家数据、游戏记录和其他公共信息的访问，允许 AI 助手搜索和分析国际象棋信息。

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

特性

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

工具列表是可配置的，因此您可以选择要提供给 MCP 客户端的工具。

用法

Docker (推荐)

使用 Docker 运行 chess-mcp 和 Claude Desktop 最简单的方法是使用 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",
        "<chess-mcp 目录的完整路径>",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

注意：如果在 Claude Desktop 中看到 Error: spawn uv ENOENT，您可能需要指定 uv 的完整路径或在配置中设置环境变量 NO_UV=1。

开发

欢迎贡献！ 如果您有任何建议或改进，请打开一个 issue 或提交一个 pull request。

本项目使用 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 .

测试

该项目包含一个测试套件，可确保功能并有助于防止回归。

使用 pytest 运行测试：

# 安装开发依赖
uv pip install -e ".[dev]"

# 运行测试
pytest

# 运行并生成覆盖率报告
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

---