Chess MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Chess MCP Server Analyze the current board and suggest the best move"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
uvxpackage 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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
Usage
Once configured, the chess server will be available to Claude through the MCP protocol. You can:
Start a new game: Ask Claude to begin a chess game
Make moves: Use standard algebraic notation (e.g., "e4", "Nf3", "O-O")
Analyze positions: Request analysis of the current board state
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:
Ensure
uvxis installed and accessible in your PATHVerify the configuration file is in the correct location
Restart Claude after making configuration changes
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 toolsget_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
Scored across 2 tools
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.
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.
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.
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
Related MCP Connectors
Chess MCP for Claude: engine analysis, attack maps, game review. One URL, no install.
Pedagogical chess intelligence for AI agents: explain positions and games for a target Elo.
Chess tools: game reviews for Chess.com and Lichess, FIDE ratings, openings, positions, puzzles.
Play chess live against your own personal AI agent โ OpenClaw, Hermes, and similar.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceEnables 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 npm2MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to play chess against users, manage games, make moves, and visualize boards with Stockfish AI opponent.81-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to play and analyze chess, validate moves, and view a live synchronized visual board in the browser through MCP tools.62 npmMIT