Chess.com MCP Server

io.github.udarrr由 GitHub 账号 udarrr 发布v0.8.8更新于 Oct 25, 2026

MCP server for Chess.com player profiles, games, stats, puzzles, clubs, and tournaments

已验证STDIO仅桌面位置与生活数据与分析

概览

AI 生成的概览

本地运行的 MCP 服务器，让助手以只读方式访问 Chess.com 公开数据：棋手资料、对局、统计、谜题、俱乐部和锦标赛。

可以做什么
查询棋手资料、统计、在线状态、有头衔棋手和排行榜，并列出棋手的俱乐部、比赛和锦标赛。获取当前对局、实时对局、待走棋对局和每月对局，并可下载棋手的 PGN 对局。浏览俱乐部资料、成员和对局，以及锦标赛轮次和分组。查看团队比赛和实时团队比赛棋盘。获取国家资料及其棋手和俱乐部、每日或随机谜题，以及主播列表。以 chess:// 资源形式提供棋手、有头衔棋手和俱乐部数据。
适用场景
适合让助手回答关于 Chess.com 棋手、对局或战绩的问题，分析某位棋手近期的对局，或在对话中跟踪俱乐部、锦标赛和团队比赛。
运行要求
通过 npx 从 npm 包 chess-mcp-node 在本地运行，需要 Node.js 20.9 或更高版本。无需身份验证、API 密钥或环境变量。需要能访问 Chess.com 公开 API 的网络；可选设置包括 SSE 传输端口和 API 基础地址覆盖。
安装前请注意
所有工具只读取 Chess.com 公开数据，所列工具不会更改账户内容。请求会发往 Chess.com 公开 API，因此你查询的用户名和内容会发送给该第三方。可选的 SSE 传输会在本地端口监听，不应对外公开。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Chess.com MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Chess.com MCP Server

A Model Context Protocol server written in TypeScript for Chess.com's public API. It exposes the complete documented Chess.com PubAPI through 30 tools and seven resources without authentication.

Install from npm

Requirements: Node.js 20.9 or newer.

Run the latest published package directly:

bash
npx -y chess-mcp-node@latest

The default transport is stdio. The package is distributed through npm and can also be installed from the VS Code MCP gallery after its registry metadata is published.

For VS Code, create or open .vscode/mcp.json in your workspace:

json
{  "servers": {    "chess": {      "command": "npx",      "args": ["-y", "chess-mcp-node@latest"]    }  }}

After publication, search for @mcp chess in VS Code and select Install to add the server from the MCP gallery.

For Claude Desktop, add the server to its MCP configuration:

json
{  "mcpServers": {    "chess": {      "command": "npx",      "args": ["-y", "chess-mcp-node@latest"]    }  }}

Run from source

Requirements: Node.js 20.9 or newer.

bash
npm cinpm run buildnpm start

The default source-run transport is stdio. To run the optional SSE transport:

bash
# macOS/LinuxMCP_TRANSPORT=sse npm start
powershell
# Windows PowerShell$env:MCP_TRANSPORT = "sse"npm start

The SSE server listens on port 8000 by default and provides /sse, /messages, and /health. Set PORT and HOST to override those defaults.

Set CHESS_API_BASE_URL to override the Chess.com API base URL for development or testing.

Development

Run the test suite and type checker:

bash
npm testnpm run typecheck

Create a coverage report with:

bash
npm run test:coverage

Available tools

  • get_player_profile
  • get_titled_players
  • get_player_stats
  • is_player_online
  • get_player_current_games
  • get_player_games_to_move
  • get_player_game_archives
  • get_player_games_by_month
  • get_player_live_games
  • download_player_games_pgn
  • get_player_clubs
  • get_player_matches
  • get_player_tournaments
  • get_club_profile
  • get_club_members
  • get_club_matches
  • get_tournament
  • get_tournament_round
  • get_tournament_round_group
  • get_team_match
  • get_team_match_board
  • get_live_team_match
  • get_live_team_match_board
  • get_country_profile
  • get_country_players
  • get_country_clubs
  • get_daily_puzzle
  • get_random_puzzle
  • get_streamers
  • get_leaderboards

Available resources

  • chess://player/{username}
  • chess://player/{username}/stats
  • chess://player/{username}/games/current
  • chess://player/{username}/games/{year}/{month}
  • chess://player/{username}/games/{year}/{month}/pgn
  • chess://titled/{title}
  • chess://club/{url_id}

License

MIT

来源：README.md，提交 ff972bf

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.8.8最新Sep 22, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分