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 客户端提供的工具。

Related MCP server: BoardGameGeek MCP Server

用法

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 运行服务器。编辑您的 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 。

发展

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

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