ChessAgine MCP

import { Chess } from "chess.js"; import { analyzeVariationThemes, findCriticalMoments} from "./ovp.js"; import { GameReview, ThemeScore } from "../types/types.js"; export function generateGameReview(pgn: string, criticalMomentThreshold: number = 0.5): GameReview { const chess = new Chess(); // Load and parse PGN chess.loadPgn(pgn); // Extract game headers const headers = chess.getHeaders(); const gameInfo = { white: headers.White || "Unknown", black: headers.Black || "Unknown", result: headers.Result || "*", event: headers.Event, date: headers.Date }; // Get move history const history = chess.history(); // Reset to starting position chess.reset(); const startingFen = chess.fen(); // Analyze for both colors const whiteAnalysis = analyzeVariationThemes(startingFen, history, "w"); const blackAnalysis = analyzeVariationThemes(startingFen, history, "b"); // Find critical moments const whiteCriticalMoments = findCriticalMoments(startingFen, history, "w", criticalMomentThreshold); const blackCriticalMoments = findCriticalMoments(startingFen, history, "b", criticalMomentThreshold); // Calculate average theme scores throughout the game const whiteAvgScores = calculateAverageScores(whiteAnalysis.moveByMoveScores); const blackAvgScores = calculateAverageScores(blackAnalysis.moveByMoveScores); // Generate insights const insights = generateInsights( whiteAnalysis, blackAnalysis, whiteCriticalMoments, blackCriticalMoments, ); return { gameInfo, whiteAnalysis: { overallThemes: whiteAnalysis, criticalMoments: whiteCriticalMoments, averageThemeScores: whiteAvgScores }, blackAnalysis: { overallThemes: blackAnalysis, criticalMoments: blackCriticalMoments, averageThemeScores: blackAvgScores }, insights }; } function calculateAverageScores(scores: Array<ThemeScore>) { const sum = scores.reduce((acc, score) => ({ material: acc.material + score.material, mobility: acc.mobility + score.mobility, space: acc.space + score.space, positional: acc.positional + score.positional, kingSafety: acc.kingSafety + score.kingSafety, tactical: acc.tactical + score.tactical, darksqaureControl: acc.darksqaureControl + score.darksqaureControl, lightsqaureControl: acc.lightsqaureControl + score.lightsqaureControl, tempo: acc.tempo + score.tempo }), { material: 0, mobility: 0, space: 0, positional: 0, kingSafety: 0, tactical: 0, darksqaureControl: 0, lightsqaureControl: 0, tempo: 0 }); const count = scores.length; return { material: parseFloat((sum.material / count).toFixed(2)), mobility: parseFloat((sum.mobility / count).toFixed(2)), space: parseFloat((sum.space / count).toFixed(2)), positional: parseFloat((sum.positional / count).toFixed(2)), kingSafety: parseFloat((sum.kingSafety / count).toFixed(2)), tactical: parseFloat((sum.tactical / count).toFixed(2)), darksqaureControl: parseFloat((sum.darksqaureControl / count).toFixed(2)), lightsqaureControl: parseFloat((sum.lightsqaureControl / count).toFixed(2)), tempo: parseFloat((sum.tempo / count).toFixed(2)) }; } function generateInsights( whiteAnalysis: ReturnType<typeof analyzeVariationThemes>, blackAnalysis: ReturnType<typeof analyzeVariationThemes>, whiteCriticalMoments: ReturnType<typeof findCriticalMoments>, blackCriticalMoments: ReturnType<typeof findCriticalMoments>, ) { // Find best and worst themes for each player const whiteBest = whiteAnalysis.strongestImprovement?.theme || "none"; const whiteWorst = whiteAnalysis.biggestDecline?.theme || "none"; const blackBest = blackAnalysis.strongestImprovement?.theme || "none"; const blackWorst = blackAnalysis.biggestDecline?.theme || "none"; // Identify turning points (critical moments with largest absolute changes) const turningPoints: Array<{ moveNumber: number; player: string; move: string; impact: string; }> = []; // Combine and sort all critical moments const allCritical = [ ...whiteCriticalMoments.map(cm => ({ ...cm, player: "White" })), ...blackCriticalMoments.map(cm => ({ ...cm, player: "Black" })) ].sort((a, b) => { const aMax = Math.max(...a.themeChanges.map(tc => Math.abs(tc.change))); const bMax = Math.max(...b.themeChanges.map(tc => Math.abs(tc.change))); return bMax - aMax; }); // Take top 5 turning points allCritical.slice(0, 10).forEach(cm => { const maxChange = cm.themeChanges.reduce((max, tc) => Math.abs(tc.change) > Math.abs(max.change) ? tc : max ); turningPoints.push({ moveNumber: Math.floor(cm.moveIndex / 2) + 1, player: cm.player, move: cm.move, impact: `${maxChange.theme}: ${maxChange.change > 0 ? '+' : ''}${maxChange.change.toFixed(2)}` }); }); return { whiteBestTheme: whiteBest, whiteWorstTheme: whiteWorst, blackBestTheme: blackBest, blackWorstTheme: blackWorst, turningPoints }; } export function formatGameReview(review: GameReview): string { let output = "=== GAME REVIEW ===\n\n"; output += `Game: ${review.gameInfo.white} vs ${review.gameInfo.black}\n`; output += `Result: ${review.gameInfo.result}\n`; output += "\n"; output += "--- WHITE'S PERFORMANCE ---\n"; output += `Overall Theme Change: ${review.whiteAnalysis.overallThemes.overallChange.toFixed(2)}\n`; output += `Best Theme: ${review.insights.whiteBestTheme}\n`; output += `Worst Theme: ${review.insights.whiteWorstTheme}\n`; output += `Critical Moments: ${review.whiteAnalysis.criticalMoments.length}\n\n`; output += "Average Theme Scores:\n"; Object.entries(review.whiteAnalysis.averageThemeScores).forEach(([theme, score]) => { output += ` ${theme}: ${score.toFixed(2)}\n`; }); output += "\n"; output += "--- BLACK'S PERFORMANCE ---\n"; output += `Overall Theme Change: ${review.blackAnalysis.overallThemes.overallChange.toFixed(2)}\n`; output += `Best Theme: ${review.insights.blackBestTheme}\n`; output += `Worst Theme: ${review.insights.blackWorstTheme}\n`; output += `Critical Moments: ${review.blackAnalysis.criticalMoments.length}\n\n`; output += "Average Theme Scores:\n"; Object.entries(review.blackAnalysis.averageThemeScores).forEach(([theme, score]) => { output += ` ${theme}: ${score.toFixed(2)}\n`; }); output += "\n"; output += "--- TURNING POINTS ---\n"; review.insights.turningPoints.forEach((tp, i) => { output += `${i + 1}. Move ${tp.moveNumber} (${tp.player}): ${tp.move}\n`; output += ` Impact: ${tp.impact}\n`; }); return output; }