Skip to main content
Glama

ChessAgine MCP

by jalpp
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote
MIT License
13

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 0: Installing via Smithery

To install ChessAgine automatically via Smithery:

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

  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 22+

  • npm or yarn package manager

Clone and Setup

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:

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

Windows:

{ "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

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

License

This project is licensed under the MIT License, the /themes and /protocol are under GPL. See the LICENSE file for details.

Authors

@jalpp

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

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