Chess Analysis Assistant

🚀 国际象棋分析助手 - 协助Claude的国际象棋分析工具

此工具借助Stockfish引擎，帮助您在Claude内部分析国际象棋位置并获得专业评估。您可以获取位置评估、查看视觉棋盘表示、分析不同走法和变体，还能在大师数据库中查找对应位置（由2200+等级分的玩家进行的比赛）。

🚀 快速开始

此工具帮助您在Claude内部分析国际象棋位置，借助Stockfish引擎提供专业评估。您可以获取位置评估、查看视觉棋盘、分析不同走法及变体，还能在大师数据库中查找对应位置。

✨ 主要特性

位置分析

• 使用Stockfish引擎进行评估
• 提供视觉棋盘表示
• 给出最佳走法建议
• 进行移动验证

大师数据库

• 可在由2200+等级分的玩家进行的比赛中的游戏位置搜索
• 支持按日期范围过滤游戏
• 能查看胜负统计信息
• 可浏览在此位置中大师中最常走的移动及其成功率
• 能查看最近的大师游戏和玩家等级分数

📦 安装指南

先决条件

• 需在计算机上安装Claude Desktop
• 系统上要安装Git

通过Smithery安装

要通过Smithery自动安装Chess Analysis Assistant for Claude Desktop，可执行以下命令：

npx -y @smithery/cli install chess-mcp --client claude

Mac和Linux用户

打开终端并运行此命令：

curl -fsSL https://raw.githubusercontent.com/turlockmike/chess-mcp/master/install.sh | bash

脚本将完成以下操作：

1. 安装所需的依赖项（Node.js 20+，Stockfish，Cairo）
2. 配置Claude Desktop
3. 设置国际象棋助手

手动安装（Windows或高级用户）

先决条件

• Claude Desktop
• Node.js版本20或更高
• 国际象棋引擎Stockfish
• （用于棋盘可视化）Cairo图形库

分步安装说明

步骤1：安装依赖项

Mac用户：

# 如果您还没有，请先安装Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装所需的软件包
brew install stockfish cairo pkg-config jq

Windows用户：

1. 安装Node.js（LTS版本）
2. 下载Stockfish并将其添加到您的PATH
3. 安装Cairo

步骤2：安装国际象棋助手

npm install -g chess-mcp

步骤3：配置Claude Desktop

1. 打开Claude Desktop
2. 浏览到配置文件：
   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json%
3. 添加以下配置：

{
"mcpServers": {
"chess": {
"command": "npx",
"args": ["chess-mcp"]
}
}
}

4. 保存并重新启动Claude Desktop

💻 使用示例

基础用法

1. 打开Claude Desktop
2. 查找工具图标（🔧）- 应该显示国际象棋分析工具
3. 可尝试以下示例提示：
   • "分析此位置：rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1"
   • "显示当前位置"
   • "此位置的最佳走法是什么？"
   • "在此位置查找大师数据库中的位置"
   • "查看此位置在2000步后的主教游戏"
   • "在此位置中，大师中最常走的移动及其成功率如何？"

📚 详细文档

如果遇到任何问题：

1. 确保所有先决条件都已正确安装
2. 检查终端或命令提示符中的输出，以获取可能的错误信息
3. 如果问题仍然存在，请访问官方文档或联系支持团队