Skip to main content
Glama

ChessAgine MCP

by jalpp
README.md5.38 kB
# ChessAgine MCP [![smithery badge](https://smithery.ai/badge/@jalpp/chessagine-mcp)](https://smithery.ai/server/@jalpp/chessagine-mcp) <p align="center"> <img src="/icon.png" alt="ChessAgine" width="200"/> </p> A comprehensive Model Context Protocol (MCP) server that provides advanced chess analysis capabilities by implementing [Chess Context Protocol Server](https://github.com/jalpp/chessagineweb/tree/main/chessContextProtocol) and integrating Stockfish engine evaluation, positional theme analysis, opening databases, puzzle training, game visualization, and chess knowledge for enhanced chess understanding and gameplay improvement. ## Preview <p align="center"> <img src="/assets/screenshots/claude2.png" alt="ChessAgine"/> </p> ## Features ### 🔧 Core Analysis Tools - **Stockfish Integration**: Deep engine analysis with configurable search depth - **Theme Analysis**: Evaluate material, mobility, space, positional factors, and king safety - **Variation Analysis**: Compare multiple lines and track positional changes - **Move Validation**: Check move legality and generate board state descriptions - **Game Review**: Comprehensive game analysis with theme progression and critical moments ### 🎮 Interactive Features - **Visual Board Rendering**: Generate HTML chess boards for any position - **Dynamic Game Viewer**: Interactive game replay with move navigation - **Puzzle Training**: Access Lichess puzzle database with theme filtering - **Game Fetching**: Retrieve user games from Lichess for analysis ### 📊 Database Integration - **Lichess Master Games**: Access master-level opening statistics and games - **Lichess User Games**: Analyze how positions are played across skill levels - **Lichess Puzzle Database**: 3+ million tactical puzzles with theme-based filtering - **ChessDB**: Query extensive game databases for move evaluations and statistics ### 🧠 Knowledge Base - **Chess Principles**: Silman's imbalances and Fine's 30 principles - **Endgame Theory**: Essential endgame knowledge and patterns - **Strategic Concepts**: Comprehensive chess improvement guidelines - **Puzzle Themes**: 150+ tactical motifs and patterns ## Installation ### Option 0: Installing via Smithery To install ChessAgine automatically via [Smithery](https://smithery.ai/server/@jalpp/chessagine-mcp): ```bash npx -y @smithery/cli install @jalpp/chessagine-mcp ``` ### Option 1: Using MCPB File (Recommended) Download the `chessagine-mcp.mcpb` file and install it directly in Claude Desktop: 1. Download the latest release from [GitHub releases](https://github.com/jalpp/chessagine-mcp/releases) 2. Open Claude Desktop 3. Go to Settings → Extensions → Install from file 4. Select the `chessagine-mcp.mcpb` file 5. Restart Claude Desktop ### Option 2: Local Development Setup #### Prerequisites - Node.js 20+ - npm or yarn package manager #### Clone and Setup ```bash git clone https://github.com/jalpp/chessagine-mcp.git cd chessagine-mcp npm install npm run build:mcp ``` #### Configure Claude Desktop Add to your `claude_desktop_config.json`: **macOS/Linux:** ```json { "mcpServers": { "chessagine-mcp": { "command": "node", "args": ["/absolute/path/to/chessagine-mcp/build/runner/stdio.js"] } } } ``` **Windows:** ```json { "mcpServers": { "chessagine-mcp": { "command": "node", "args": ["C:\\absolute\\path\\to\\chessagine-mcp\\build\\runner\\stdio.js"] } } } ``` ### Easy setup Follow Option 1 and upload the generated mcpb file to Claude Desktop directly. ## Usage Examples ### Basic Position Analysis ``` Analyze this position: rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1 ``` ### Visual Board Display ``` Show me the board for this position: r1bqkbnr/pppp1ppp/2n5/4p3/4P3/5N2/PPPP1PPP/RNBQKB1R w KQkq - 2 3 ``` ### Game Review ``` Review this game and identify critical moments: [Event "Casual Game"] [White "Player1"] [Black "Player2"] 1. e4 e5 2. Nf3 Nc6 3. Bb5 a6... ``` ### Puzzle Training ``` Give me a tactical puzzle rated between 1500-1800 with a fork theme ``` ### Fetch User Games ``` Show me the recent games for Lichess user "Magnus_Carlsen" ``` ### Interactive Game Viewer ``` Create an interactive viewer for this game: https://lichess.org/abc12345 ``` ### Opening Exploration ``` What are the master games for the Sicilian Defense after 1.e4 c5 2.Nf3 d6? ``` ### Engine Analysis ``` Run Stockfish analysis on this position at depth 15: r1bqk2r/pppp1ppp/2n2n2/2b1p3/2B1P3/3P1N2/PPP2PPP/RNBQK2R w KQkq - 4 5 ``` ### Variation Comparison ``` Compare these variations from the starting position: 1. e4 e5 2.Nf3 Nc6 3.Bb5 2. e4 e5 2.Nf3 Nc6 3.Bc4 3. e4 e5 2.Nf3 Nc6 3.d4 ``` ### Theme Analysis ``` Analyze how the king safety theme changes in this line: 1.e4 e5 2.f4 exf4 3.Bc4 Qh4+ 4.Kf1 ``` ## Tools & Credits See ```tools.md``` for detailed breakdown on tools and their descriptions ## Development ### Dev commands ```bash npm run build:mcp # Build the projects and mcpb file npm run dev # test and interact with chessAgine via smithery npm run debug # opens MCP inspector to inspect new changes made ``` ## Community - **Discord**: [Join ChessAgine community](https://discord.gg/N2J2sP9yTm) ## License This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details. ## Authors @jalpp

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jalpp/chessagine-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server