Skip to content
Back to search

chess-mcp

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pab1it0--chess-mcp/badge.svg)](/listings/pab1it0--chess-mcp)

HTML

<a href="/listings/pab1it0--chess-mcp"><img src="/api/listings/pab1it0--chess-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 135 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Chess.com MCP Server
  2. A [Model Context Protocol][mcp] (MCP) server for Chess.com's Published Data API.
  3. 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.
  4. https://github.com/user-attachments/assets/3b33361b-b604-465c-9f6a-3699b6907757
  5. [mcp]: https://modelcontextprotocol.io/introduction/introduction
  6. ## Features
  7. - [x] Access player profiles, stats, and game records
  8. - [x] Search games by date and player
  9. - [x] Check player online status
  10. - [x] Get information about clubs and titled players
  11. - [x] No authentication required (uses Chess.com's public API)
  12. - [x] Docker containerization support
  13. - [x] Provide interactive tools for AI assistants
  14. The list of tools is configurable, so you can choose which tools you want to make available to the MCP client.
  15. ## Usage
  16. ### Docker (Recommended)
  17. The easiest way to run chess-mcp with [Claude Desktop](https://claude.ai/desktop) is using Docker. If you don't have Docker installed, you can get it from [Docker's official website](https://www.docker.com/get-started/).
  18. Edit your Claude Desktop config file:
  19. * Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
  20. * Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  21. * Linux: `~/.config/Claude/claude_desktop_config.json`
  22. Then add the following configuration:
  23. ```json
  24. {
  25. "mcpServers": {
  26. "chess": {
  27. "command": "docker",
  28. "args": [
  29. "run",
  30. "--rm",
  31. "-i",
  32. "pab1it0/chess-mcp"
  33. ]
  34. }
  35. }
  36. }
  37. ```
  38. ### Running with UV
  39. Alternatively, you can run the server directly using UV. Edit your Claude Desktop config file (locations listed above) and add the server configuration:
  40. ```json
  41. {
  42. "mcpServers": {
  43. "chess": {
  44. "command": "uv",
  45. "args": [
  46. "--directory",
  47. "<full path to chess-mcp directory>",
  48. "run",
  49. "src/chess_mcp/main.py"
  50. ]
  51. }
  52. }
  53. }
  54. ```
  55. > Note: if you see `Error: spawn uv ENOENT` in [Claude Desktop](https://claude.ai/desktop), you may need to specify the full path to `uv` or set the environment variable `NO_UV=1` in the configuration.
  56. ## Development
  57. Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.
  58. This project uses [`uv`](https://github.com/astral-sh/uv) to manage dependencies. Install `uv` following the instructions for your platform:
  59. ```bash
  60. curl -LsSf https://astral.sh/uv/install.sh | sh
  61. ```
  62. You can then create a virtual environment and install the dependencies with:
  63. ```bash
  64. uv venv
  65. source .venv/bin/activate # On Unix/macOS
  66. .venv\Scripts\activate # On Windows
  67. uv pip install -e .
  68. ```
  69. ### Testing
  70. The project includes a test suite that ensures functionality and helps prevent regressions.
  71. Run the tests with pytest:
  72. ```bash
  73. # Install development dependencies
  74. uv pip install -e ".[dev]"
  75. # Run the tests
  76. pytest
  77. # Run with coverage report
  78. pytest --cov=src --cov-report=term-missing
  79. ```
  80. ## Available Tools
  81. ### Player Information
  82. - `get_player_profile` - Get a player's profile from Chess.com
  83. - `get_player_stats` - Get a player's stats from Chess.com
  84. - `is_player_online` - Check if a player is currently online on Chess.com
  85. - `get_titled_players` - Get a list of titled players from Chess.com
  86. ### Games
  87. - `get_player_current_games` - Get a player's ongoing games on Chess.com
  88. - `get_player_games_by_month` - Get a player's games for a specific month from Chess.com
  89. - `get_player_game_archives` - Get a list of available monthly game archives for a player on Chess.com
  90. - `download_player_games_pgn` - Download PGN files for all games in a specific month from Chess.com
  91. ### Clubs
  92. - `get_club_profile` - Get information about a club on Chess.com
  93. - `get_club_members` - Get members of a club on Chess.com
  94. ## License
  95. MIT
  96. ---
  97. [mcp]: https://modelcontextprotocol.io

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.