Chess.com MCP Server

Name: Chess.com MCP Server
Author: pab1it0

@pab1it0

关于 Chess.com MCP Server

A Model Context Protocol server for Chess.com's Published Data API. This provides access to Chess.com player data, game records, and other public information through standardized MCP interfaces, allowing AI assistants to search and analyze chess information.

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

pab1it0

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "chess-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Chess.com MCP Server?

A Model Context Protocol (MCP) server for Chess.com's Published Data API. It provides access to player profiles, game records, and other public chess information through standardized MCP interfaces, allowing AI assistants to search and analyze chess data.

How to use Chess.com MCP Server?

Run the server via Docker (recommended) or directly with UV. Configure your MCP client (e.g., Claude Desktop) to use the server by editing its config file with the appropriate command and arguments. No authentication is required.

Key features of Chess.com MCP Server

Access player profiles, stats, and game records
Search games by date and player
Check player online status
Get information about clubs and titled players
No authentication required (uses Chess.com's public API)
Docker containerization support
Configurable toolset for AI assistants

Use cases of Chess.com MCP Server

AI assistants answering questions about a player's profile, stats, or recent games
Analyzing a player's game archives by month or downloading PGN files
Checking whether a specific player is currently online on Chess.com
Retrieving club profiles and member lists
Discovering titled players (e.g., grandmasters) by title

FAQ from Chess.com MCP Server

Do I need an API key to use Chess.com MCP Server?

No, it uses Chess.com's free Published Data API which requires no authentication.

How do I run Chess.com MCP Server?

The easiest way is via Docker: add a configuration entry in your MCP client's config file using docker run --rm -i pab1it0/chess-mcp. Alternatively, run it with UV using uv run src/chess_mcp/main.py.

What tools does Chess.com MCP Server provide?

Tools include get_player_profile, 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, get_club_profile, and get_club_members.

Can I limit which tools are available to my AI assistant?

Yes, the list of tools is configurable, so you can choose which tools to expose to the MCP client.

What dependencies does it require?

It uses Python and the uv package manager for development. For production, Docker is recommended to avoid dependency issues. The server communicates over standard MCP transports (stdio).