A comprehensive MCP server that provides advanced chess analysis capabilities by integrating the Stockfish engine for position evaluation, positional theme analysis, opening databases, tactics training, and game visualization to improve chess understanding and enhance playing strength.

Installation

Smithery

npx -y @smithery/cli install @jalpp/chessagine-mcp

MCPB File

1. Download the latest release from GitHub releases
2. Open Claude Desktop
3. Go to Settings → Extensions → Install from file
4. Select the chessagine-mcp.mcpb file
5. Restart Claude Desktop

From Source Code

git clone https://github.com/jalpp/chessagine-mcp.git
cd chessagine-mcp
npm install
npm run build:mcp

Configuration

Claude Desktop (macOS/Linux)

{
  "mcpServers": {
    "chessagine-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/chessagine-mcp/build/runner/stdio.js"]
    }
  }
}

Claude Desktop (Windows)

{
  "mcpServers": {
    "chessagine-mcp": {
      "command": "node",
      "args": ["C:\\absolute\\path\\to\\chessagine-mcp\\build\\runner\\stdio.js"]
    }
  }
}

Features

• Stockfish Integration: Deep engine analysis with customizable search depth
• Thematic Analysis: Evaluation of material, mobility, space, positional factors, and king safety
• Variation Analysis: Comparison of multiple lines and tracking positional changes
• Move Validation: Legality checking and board state description generation
• Game Analysis: Comprehensive game analysis with theme progression and critical moments
• Board Visualization: HTML chess board generation for any position
• Dynamic Game Viewer: Interactive game replay with move navigation
• Tactics Training: Access to Lichess puzzle database with theme filtering
• Game Loading: Retrieval of user games from Lichess for analysis
• Lichess Master Games: Access to opening statistics and master-level games

Usage Examples

Analyze this position: rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1

Show me the board for this position: r1bqkbnr/pppp1ppp/2n5/4p3/4P3/5N2/PPPP1PPP/RNBQKB1R w KQkq - 2 3

Give me a tactical puzzle rated between 1500-1800 with a fork theme

Show me the recent games for Lichess user "Magnus_Carlsen"

Create an interactive viewer for this game: https://lichess.org/abc12345

Notes

Prerequisites: Node.js 22+ and a package manager npm or yarn. See tools.md for detailed descriptions of tools and their functions. Development commands available: npm run build:mcp, npm run dev, npm run debug. Discord community available at https://discord.gg/suepW7FRCY