Chess-analysis-mcp/tintins-chess-analysis

View on GitHub ↗

Stockfish-powered chess coach that explains your mistakes in plain English.

36 ★10 forksPythonUpdated 1mo ago

What you need to know

Chess coaching app and MCP server for Claude Code. Reviews games with Stockfish and explains every mistake in plain English, with an interactive web board (eval bar, win graph, move arrows) and a puzzle trainer with Glicko-2 rating, Storm mode, and an AI coach that teaches patterns.

Install

./install.sh (or install.ps1 on Windows)

Usage

  • •Run the installer, reload Claude Code, paste a PGN, and ask the agent to analyze the game; the web board opens at http://127.0.0.1:8765.

Key features

  • ✓Full-game review grounded in Stockfish lines
  • ✓Plain-English move explanations
  • ✓Interactive web board
  • ✓Puzzle trainer (Glicko-2, Storm, daily streak, weakness training)
  • ✓Game history and coaching profile
  • ✓Optional local model (Ollama/LM Studio) instead of Claude

Best for

Game review and chess improvement coaching from an agent or web board

Caveats

  • ⚠AI explanations require the claude CLI logged in (or a local model)
  • ⚠First-time setup needs network (Python, Stockfish, puzzles)
Clients: Claude Code
Documentation ↗

Reviewed 2026-08-11

Topics

chesschess-analysischess-engineclaudefastapimcpmodel-context-protocolpythonstockfish
Stars
36★
Forks
10
Language
Python
License
MIT
Created
2026-06-15
Last push
2026-07-18