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.

Related MCP server: Chess.com MCP Server

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.