Integrates with Spring AI and chess libraries to enable interactive gameplay and automated analysis for AI-assisted ches...
Created byApr 23, 2025
MCP Chess
A [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that provides
chess functionality for [Claude AI](https://claude.ai/) Assistant.
This server implements tools that extend Claude's capabilities to:
Generate chess board images from a Forsyth-Edwards Notation (FEN) string
Suggest the next move in a chess game
Check if a move is legal
Installation for Claude Desktop
Download the latest binary from the [Releases](https://github.com/alexandreroman/mcp-chess/releases) page:
- For Windows: `mcp-chess-windows.exe`
- For macOS: `mcp-chess-darwin`
- For Linux: `mcp-chess-linux`
Make the file executable (macOS/Linux only):
```bash
chmod +x mcp-chess-darwin # for macOS
chmod +x mcp-chess-linux # for Linux
```
For macOS users - Bypassing Security Warnings:
When you first try to run the application, macOS may display a security warning because the application is not signed by an identified developer. To bypass this:
- Right-click (or Control-click) on the `mcp-chess-darwin` file
- Select "Open" from the context menu
- Click "Open" in the dialog box that appears
Alternatively, you can use Terminal:
```bash
xattr -d com.apple.quarantine /path/to/mcp-chess-darwin
```
This only needs to be done once.
Configure Claude Desktop:
- Open Claude Desktop
- Select "Settings", and click on the "Developer" tab
- Click "Edit Config"
- Add the MCP server configuration
- Save the file
- Restart Claude Desktop
Here's an example for the MCP server configuration:
Using with Claude
Once properly configured, you can ask Claude to perform various chess-related tasks:
Technical Details
Development
This project is built with:
Spring Boot
Spring AI (MCP server implementation)
Java 21
GraalVM native compilation
Building from Source
License
This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.