Offers community support through a Discord server for ChessAgine users to get help and engage with other chess enthusiasts.
Integrates with GitHub for project hosting, issue tracking, feature requests, and accessing releases including the MCPB installation files.
Provides access to Lichess's extensive chess database including 3+ million tactical puzzles with theme filtering, master game statistics, opening explorer data, and user game history retrieval for comprehensive chess analysis and training.
ChessAgine MCP
A comprehensive Model Context Protocol (MCP) server that provides advanced chess analysis capabilities by implementing Chess Context Protocol Server 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
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 1: Using MCPB File (Recommended)
Download the chessagine-mcp.mcpb
file and install it directly in Claude Desktop:
Download the latest release from GitHub releases
Open Claude Desktop
Go to Settings → Extensions → Install from file
Select the
chessagine-mcp.mcpb
fileRestart Claude Desktop
Option 2: Local Development Setup
Prerequisites
Node.js 20+
npm or yarn package manager
Clone and Setup
Configure Claude Desktop
Add to your claude_desktop_config.json
:
macOS/Linux:
Windows:
Usage Examples
Basic Position Analysis
Visual Board Display
Game Review
Puzzle Training
Fetch User Games
Interactive Game Viewer
Opening Exploration
Engine Analysis
Variation Comparison
Theme Analysis
Available Tools
Tool | Description |
Position Analysis | |
| Analyze positional themes for strategic evaluation |
| Track theme evolution across move sequences |
| Monitor specific theme development |
| Side-by-side variation analysis |
| Identify key turning points |
Engine & Evaluation | |
| Deep engine position analysis |
| Post-move position evaluation |
| Move validation |
| Convert positions to text descriptions |
Knowledge & Database | |
| Access comprehensive chess knowledge |
| Master game database queries |
| User game statistics |
| ChessDB position analysis |
Visualization | |
| Render chess board in HTML |
| Create interactive game viewer |
Puzzle Training | |
| Fetch puzzles from Lichess (filter by theme/rating) |
| List all available puzzle themes |
Game Analysis | |
| Fetch user's 20 most recent games |
| Fetch specific game by URL or ID |
| Generate detailed game review with themes |
| Convert PGN to FEN position list |
Available Prompts
Prompt | Description |
| Comprehensive positional analysis |
Puzzle Training Features
ChessAgine MCP now includes access to Lichess's extensive puzzle database with:
3+ Million Puzzles: Tactical problems for all skill levels
150+ Themes: Fork, pin, skewer, mate patterns, endgames, and more
Rating Filter: Find puzzles matching your skill level (500-3000+)
Theme Combinations: Query multiple themes simultaneously
Instant Feedback: Validate solutions with engine analysis
Popular Puzzle Themes
Tactical Motifs: fork, pin, skewer, discoveredAttack, deflection
Checkmate Patterns: mateIn1, mateIn2, mateIn3, backRankMate, smotheredMate
Endgame Skills: pawnEndgame, rookEndgame, queenEndgame, promotion
Strategic Elements: zugzwang, clearance, interference, attraction
Game Review System
The new game review system provides comprehensive analysis:
Theme Progression: Track material, mobility, space, positional play, and king safety
Critical Moments: Automatically identify turning points in the game
Visual Analytics: Generate charts and graphs of theme evolution
Format Options: JSON data or human-readable text reports
Configurable Threshold: Adjust sensitivity for detecting critical moments
API Integration
The server integrates with several chess APIs:
Lichess Explorer API: Opening statistics and master games
Lichess Puzzle API: Tactical puzzle database with 3M+ positions
Lichess Game API: User game history and specific game fetching
ChessDB API: Position analysis and move databases
Stockfish API: Engine evaluation and analysis
Development
Building from Source
Contributing
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature
)Commit your changes (
git commit -m 'Add amazing feature'
)Push to the branch (
git push origin feature/amazing-feature
)Open a Pull Request
Support
Discord: Join ChessAgine community
GitHub Issues: Report bugs or request features
Documentation: Full documentation
License
This project is licensed under the MIT License. See the LICENSE file for details.
Acknowledgments
Stockfish: The powerful chess engine powering analysis
Lichess: Open-source chess platform providing game data and puzzles
ChessDB: Comprehensive chess position database
Anthropic: Model Context Protocol specification and tools
Authors
@jalpp
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables comprehensive chess analysis through Stockfish engine integration, positional evaluation, puzzle training, game review, and access to extensive chess databases. Provides visual board rendering, interactive game viewers, and tactical puzzle training with 3+ million problems from Lichess.