suraj-yadav-aiml/chess-mcp-example

Chess.com MCP Server

A simple Model Context Protocol (MCP) server to fetch Chess.com player data.

What is this?

This is a fun learning project to get hands-on experience with Model Context Protocol. It provides two simple tools to fetch player information from Chess.com's public API:

• Get Player Profile - Fetch public profile information (name, avatar, followers, etc.)
• Get Player Stats - Fetch player statistics (ratings for different game modes)

Installation

Add this to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "chess.com": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/suraj-yadav-aiml/chess-mcp-example.git",
        "chess"
      ]
    }
  }
}

Usage

Once installed, you can ask Claude to:

• "Get the profile of chess player hikaru"
• "Show me the stats for chess player GothamChess"
• "What's the rating of player MagnusCarlsen?"

Project Structure

chess-mcp/
├── src/
│   └── chess/
│       ├── __init__.py
│       ├── server.py        # MCP server with tool definitions
│       └── chess_api.py     # Chess.com API client
├── pyproject.toml
└── README.md

Requirements

• Python 3.12+
• httpx
• mcp[cli]