chess-mcp 是一个 Model Context Protocol（MCP）服务器，用于接入 Chess.com 的 Published Data API。它通过标准化的 MCP 接口提供对 Chess.com 玩家数据、对局记录和其他公开信息的访问，使 AI 助手能够搜索和分析国际象棋信息。
主要能力包括：访问玩家个人资料、统计数据和比赛记录；按日期和玩家搜索对局；检查玩家在线状态；获取俱乐部和有头衔棋手的信息。该项目无需认证（使用 Chess.com 的公开 API），支持 Docker 容器化，并为 AI 助手提供交互式工具。工具列表可配置，用户可以选择向 MCP 客户端提供哪些工具。
使用方式：推荐使用 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。然后添加相应配置。也可以使用 UV 直接运行服务器，编辑上述位置的 Claude Desktop 配置文件并添加服务器配置。注意：如果在 Claude Desktop 中看到 Error: spawn uv ENOENT，可能需要指定 uv 的完整路径，或在配置中设置环境变量 NO_UV=1。
项目使用 uv 管理依赖，可按照平台说明安装 uv，然后创建虚拟环境并安装依赖。项目包含测试套件，用于确保功能正常并防止回归，可使用 pytest 运行测试。
可用工具包括：get_player_profile（获取玩家在 Chess.com 的个人资料）、get_player_stats（获取玩家统计）、is_player_online（检查玩家当前是否在线）、get_titled_players（获取有头衔棋手列表）、get_player_current_games（获取玩家进行中的对局）、get_player_games_by_month（获取玩家指定月份的对局）、get_player_game_archives（获取玩家可用的月度对局存档列表）、download_player_games_pgn（下载指定月份所有对局的 PGN 文件）、get_club_profile（获取 Chess.com 俱乐部信息）、get_club_members（获取俱乐部成员）。
适用场景：为 AI 助手提供国际象棋数据查询与分析能力，例如查询玩家资料、统计、对局历史、在线状态、俱乐部信息等。限制方面，资料未提供更多关于速率限制、数据范围或错误处理的说明。
