|
|
--- |
|
|
tags: [mcp-server, mcp-server-track, chess, chessboard, games] |
|
|
title: Chess Agent MCP Server |
|
|
emoji: ♟️ |
|
|
colorFrom: yellow |
|
|
colorTo: green |
|
|
sdk: docker |
|
|
pinned: false |
|
|
license: apache-2.0 |
|
|
short_description: MCP server providing useful tools for chess agents |
|
|
--- |
|
|
|
|
|
# Chess MCP Server |
|
|
|
|
|
This is a specialized MCP server tailored for chess, designed to enhance interactions with Large Language Models (LLMs) by providing structured chess-related information and analysis. |
|
|
|
|
|
--- |
|
|
|
|
|
## Overview |
|
|
|
|
|
The Chess MCP Server offers chess-specific functionalities leveraging powerful chess engines, heuristic evaluations, and opening databases. It is used primarily by chess-related agents such as the [Chess Agent](https://huggingface.co/spaces/Agents-MCP-Hackathon/chess-agent). |
|
|
|
|
|
## Available API Functions |
|
|
|
|
|
### 1. **`get_position`** |
|
|
|
|
|
* **Description:** Analyzes and describes the current chess position, classifies the opening if possible, or provides a piece map and legal moves. |
|
|
* **Input:** `{ fen: string }` |
|
|
|
|
|
### 2. **`get_square_info`** |
|
|
|
|
|
* **Description:** Retrieves details about a specific square, including the piece occupying it, and identifies attackers and defenders. |
|
|
* **Input:** `{ fen: string, square_name: string }` |
|
|
|
|
|
### 3. **`get_top_moves`** *(Uses Stockfish chess engine)* |
|
|
|
|
|
* **Description:** Provides top N recommended moves with evaluation scores. |
|
|
* **Input:** `{ fen: string, top_n: number }` |
|
|
|
|
|
### 4. **`analyze_pawn_structure`** |
|
|
|
|
|
* **Description:** Evaluates pawn structure for both sides from the given position. |
|
|
* **Input:** `{ fen: string }` |
|
|
|
|
|
### 5. **`analyze_tactical_patterns`** |
|
|
|
|
|
* **Description:** Detects tactical patterns such as forks, pins, skewers, discovered attacks, and x-ray attacks. |
|
|
* **Input:** `{ fen: string }` |
|
|
|
|
|
### 6. **`evaluate_king_safety`** |
|
|
|
|
|
* **Description:** Assesses the king safety for both sides. |
|
|
* **Input:** `{ fen: string }` |
|
|
|
|
|
### 7. **`classify_opening`** |
|
|
|
|
|
* **Description:** Classifies chess openings from a FEN string using the Lichess openings database. |
|
|
* **Input:** `{ fen: string }` |
|
|
|
|
|
### 8. **`find_opening_by_name`** |
|
|
|
|
|
* **Description:** Searches for openings by name in the Lichess openings database. |
|
|
* **Input:** `{ name: string }` |
|
|
|
|
|
--- |
|
|
|
|
|
## Use Cases |
|
|
|
|
|
* Enhance chess reasoning capabilities of LLM-powered agents. |
|
|
* Provide structured chess insights for educational tools and interactive chess applications. |
|
|
* Improve accuracy of chess-related interactions by providing engine-backed evaluations. |
|
|
|
|
|
--- |
|
|
|
|
|
Enjoy building smarter, chess-aware applications with the Chess MCP Server! |
|
|
|
