MCP Chess Server
Overview
This repository provides a Model Context Protocol (MCP) server that exposes Chess.com data through Anthropic's FastMCP framework. The server runs over stdio and can be launched locally or directly from Claude Desktop.
Capabilities
get_chess_player_profile: Returns the public profile for a Chess.com username by callinghttps://api.chess.com/pub/player/{username}viarequests.get_chess_player_stats: Retrieves rating history and performance metrics fromhttps://api.chess.com/pub/player/{username}/stats.
Both tools are registered with FastMCP('Chess.com') in chess.server and are available to any MCP-compatible client once the server is running.
Prerequisites
- Python 3.13 or newer
- Git
- uv for dependency management
- Claude Desktop (or another MCP client)
Setup
1. Clone the repository
git clone <your-repo-url>
cd mcp-build-chess
2. Install dependencies in editable mode
uv pip install -e .
Tip: create an isolated environment with
uv venv .venvand activate it before installing.
3. Validate the server locally
uv run python -m chess.server
The server will start and wait on stdio. Use Ctrl+C to stop it once you've confirmed it launches without errors.
Claude Desktop Integration
Update claude_desktop_config.json so Claude Desktop can launch the server from this repository:
claude coinfiguration form local
{
"mcpServers": {
"Chess_Server": {
"command": "uv",
"args": [
"--directory",
"W:\\ITversity\\MCP Claude\\code\\mcp-build-chess\\src\\chess",
"run",
"chess"
]
}
}
}
##claude configuration from git repo
{
"mcpServers": {
"Chess_Server_git": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Ramakrishna-Gedala/mcp_chess.git@main",
"chess-server"
]
}
}
}
Replace the cwd value with the absolute path to your cloned repository. macOS and Linux users should specify their own path syntax (for example, /Users/you/src/mcp-build-chess). After saving the config, restart Claude Desktop so it picks up the new server configuration.