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 calling https://api.chess.com/pub/player/{username} via requests.
get_chess_player_stats: Retrieves rating history and performance metrics from https://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 .venv and 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.