Skip to main content
Glama
Chess MCP Server

Chess MCP Server

by chatkausik

Chess MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to play and analyze chess games.

Overview

This MCP server provides chess functionality through the Model Context Protocol, allowing AI assistants like Claude to:

  • Play chess games with proper move validation

  • Analyze positions and suggest moves

  • Track game state and history

  • Support standard chess notation

Related MCP server: Chess Engine MCP Server

Installation

Prerequisites

  • Python 3.8 or higher

  • uvx package runner

Setup

Add the following configuration to your MCP settings file (typically claude_desktop_config.json):

{
  "mcpServers": {
    "chess": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/chatkausik/Chess-mcp-server-build.git",
        "chess"
      ]
    }
  }
}

Configuration File Location

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Usage

Once configured, the chess server will be available to Claude through the MCP protocol. You can:

  1. Start a new game: Ask Claude to begin a chess game

  2. Make moves: Use standard algebraic notation (e.g., "e4", "Nf3", "O-O")

  3. Analyze positions: Request analysis of the current board state

  4. Review game history: View previous moves and positions

Features

  • โ™Ÿ๏ธ Full chess rule implementation

  • โœ… Move validation and legal move generation

  • ๐Ÿ“Š Position evaluation and analysis

  • ๐Ÿ“ Game history tracking

  • ๐ŸŽฏ Support for standard chess notation

  • ๐Ÿ”„ Game state persistence during session

Example Interactions

User: Let's play chess. I'll be white.
Claude: I'll start a new game. Make your first move!

User: e4
Claude: Good opening! I'll respond with e5.

User: Analyze the position
Claude: [Provides analysis of current board state]

Development

Repository

Source code: https://github.com/chatkausik/Chess-mcp-server-build

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests to the GitHub repository.

Technical Details

This server uses:

  • MCP Protocol: Model Context Protocol for AI integration

  • Python Chess Library: For game logic and validation

  • uvx: For package execution and management

Troubleshooting

If you encounter issues:

  1. Ensure uvx is installed and accessible in your PATH

  2. Verify the configuration file is in the correct location

  3. Restart Claude after making configuration changes

  4. Check that you have an active internet connection for initial installation

License

Please refer to the repository for license information.

Support

For bugs, feature requests, or questions, please open an issue on the GitHub repository.


Made with โ™Ÿ๏ธ by the chess MCP community

Available Tools

2 tools
get_chess_player_profileB

Get the public profile for a Chess.com player by username.

Inputs: username (required).

get_chess_player_statsB

Get the stats for a Chess.com player by username.

Inputs: username (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    B3.2/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools target distinct aspects of a player: profile (general info) and stats (performance metrics). While both relate to a single player, they are clearly differentiated by their descriptions and purpose. There is minimal risk of confusion.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern: get_chess_player_profile and get_chess_player_stats. The naming is uniform, predictable, and clearly indicates the resource and action.

    Tool Count3/5

    With only 2 tools, the server feels minimal, but it does cover two core capabilities. The count is borderline per the rubricโ€”it's not trivial, but it's on the lower end of acceptable for a focused server.

    Completeness2/5

    The tool surface is severely limited for a chess domain. Obvious missing operations include fetching games, looking up leaderboards, or searching players. Agents would need many additional tools to perform common chess-related tasks, leaving significant gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables playing chess games with legal move validation and AI opponent moves powered by the Stockfish engine. Supports multiple concurrent games and provides moves in UCI format.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to perform professional-grade chess analysis using Stockfish and optionally Leela Chess Zero, including position analysis, full game review, opening lookup, and puzzle generation.
      9 npm
      2
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to play chess against users, manage games, make moves, and visualize boards with Stockfish AI opponent.
      8
      1
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to play and analyze chess, validate moves, and view a live synchronized visual board in the browser through MCP tools.
      62 npm
      MIT