HelloWorld
登录
国

国际象棋MCP工具

通过标准化的MCP接口，提供对Chess.com玩家数据、对局记录和公开信息的访问，使人工智能助手能够搜索和分析国际象棋信息。

games-and-gamificationsearch

56 查看 · 2026-07-07 更新

简介

通过标准化的MCP接口，提供对Chess.com玩家数据、对局记录和公开信息的访问，使人工智能助手能够搜索和分析国际象棋信息。

简介

通过标准化的MCP接口，提供对Chess.com玩家数据、对局记录和公开信息的访问，使人工智能助手能够搜索和分析国际象棋信息。

Chess.com MCP 服务器

一个用于 Chess.com 发布数据 API 的 模型上下文协议 (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 是最简单的方法。如果您还没有安装 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 - 检查玩家是否当前在线
  • 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

服务配置

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

来源