chessagine-mcp

🚀 ChessAgine MCP

ChessAgine MCP 是一个全面的模型上下文协议（MCP）服务器，它通过实现 国际象棋上下文协议服务器 并集成 Stockfish 引擎评估、局面主题分析、开局数据库、谜题训练、棋局可视化和国际象棋知识，提供高级的国际象棋分析功能，有助于提升对国际象棋的理解和游戏水平。

🚀 快速开始

你可以按照以下不同方式安装 ChessAgine MCP：

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 ChessAgine MCP，请运行以下命令：

npx -y @smithery/cli install @jalpp/chessagine-mcp

选项 1：使用 MCPB 文件（推荐）

下载 chessagine-mcp.mcpb 文件并直接在 Claude Desktop 中安装：

1. 从 GitHub 发布页面 下载最新版本。
2. 打开 Claude Desktop。
3. 转到设置 → 扩展 → 从文件安装。
4. 选择 chessagine-mcp.mcpb 文件。
5. 重启 Claude Desktop。

选项 2：本地开发设置

前提条件

• Node.js 20+
• npm 或 yarn 包管理器

克隆并设置项目

git clone https://github.com/jalpp/chessagine-mcp.git
cd chessagine-mcp
npm install
npm run build

配置 Claude Desktop

将以下内容添加到你的 claude_desktop_config.json 文件中：

macOS/Linux：

{
  "mcpServers": {
    "chessagine-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/chessagine-mcp/build/mastra/stdio.js"]
    }
  }
}

Windows：

{
  "mcpServers": {
    "chessagine-mcp": {
      "command": "node", 
      "args": ["C:\\absolute\\path\\to\\chessagine-mcp\\build\\mastra\\stdio.js"]
    }
  }
}

✨ 主要特性

🔧 核心分析工具

• Stockfish 集成：深度引擎分析，可配置搜索深度。
• 主题分析：评估子力、子力机动性、空间、局面因素和王的安全性。
• 变例分析：比较多条变化线路并跟踪局面变化。
• 着法验证：检查着法合法性并生成棋盘状态描述。
• 棋局回顾：全面的棋局分析，包括主题进展和关键时刻。

🎮 交互功能

• 可视化棋盘渲染：为任何局面生成 HTML 国际象棋棋盘。
• 动态棋局查看器：交互式棋局回放，可进行着法导航。
• 谜题训练：访问 Lichess 谜题数据库，支持主题过滤。
• 棋局获取：从 Lichess 获取用户棋局进行分析。

📊 数据库集成

• Lichess 大师棋局：访问大师级开局统计数据和棋局。
• Lichess 用户棋局：分析不同水平玩家对局面的处理方式。
• Lichess 谜题数据库：300 多万个战术谜题，支持基于主题的过滤。
• ChessDB：查询广泛的棋局数据库，获取着法评估和统计数据。

🧠 知识库

• 国际象棋原则：Silman 的不平衡理论和 Fine 的 30 条原则。
• 残局理论：基本的残局知识和模式。
• 战略概念：全面的国际象棋提升指南。
• 谜题主题：150 多种战术主题和模式。

💻 使用示例

基础局面分析

Analyze this position: rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1

可视化棋盘显示

Show me the board for this position: r1bqkbnr/pppp1ppp/2n5/4p3/4P3/5N2/PPPP1PPP/RNBQKB1R w KQkq - 2 3

棋局回顾

Review this game and identify critical moments:
[Event "Casual Game"]
[White "Player1"]
[Black "Player2"]
1. e4 e5 2. Nf3 Nc6 3. Bb5 a6...

谜题训练

Give me a tactical puzzle rated between 1500-1800 with a fork theme

获取用户棋局

Show me the recent games for Lichess user "Magnus_Carlsen"

交互式棋局查看器

Create an interactive viewer for this game: https://lichess.org/abc12345

开局探索

What are the master games for the Sicilian Defense after 1.e4 c5 2.Nf3 d6?

引擎分析

Run Stockfish analysis on this position at depth 15: r1bqk2r/pppp1ppp/2n2n2/2b1p3/2B1P3/3P1N2/PPP2PPP/RNBQK2R w KQkq - 4 5

变例比较

Compare these variations from the starting position:
1. e4 e5 2.Nf3 Nc6 3.Bb5
2. e4 e5 2.Nf3 Nc6 3.Bc4
3. e4 e5 2.Nf3 Nc6 3.d4

主题分析

Analyze how the king safety theme changes in this line: 1.e4 e5 2.f4 exf4 3.Bc4 Qh4+ 4.Kf1

📚 详细文档

可用工具

| 属性 | 详情 | |------|------| | 局面分析 | | get-theme-scores | 分析局面主题以进行战略评估 | | analyze-variation-themes | 跟踪着法序列中主题的演变 | | get-theme-progression | 监控特定主题的发展 | | compare-variations | 并排比较变例 | | find-critical-moments | 识别关键转折点 | | 引擎与评估 | | get-stockfish-analysis | 深度引擎局面分析 | | get-stockfish-move-analysis | 着法后的局面评估 | | is-legal-move | 着法验证 | | boardstate-to-prompt | 将局面转换为文本描述 | | 知识与数据库 | | get-chess-knowledgebase | 访问全面的国际象棋知识 | | get-lichess-master-games | 查询大师棋局数据库 | | get-lichess-games | 用户棋局统计数据 | | get-chessdb-analysis | ChessDB 局面分析 | | 可视化 | | generate-chess-board-view-artifact-using-html | 用 HTML 渲染国际象棋棋盘 | | generate-dynamic-gameview-html | 创建交互式棋局查看器 | | 谜题训练 | | fetch-chess-puzzle | 从 Lichess 获取谜题（按主题/等级过滤） | | get-puzzle-themes | 列出所有可用的谜题主题 | | 棋局分析 | | fetch-lichess-games | 获取用户最近的 20 局棋局 | | fetch-lichess-game | 通过 URL 或 ID 获取特定棋局 | | generate-game-review | 生成包含主题的详细棋局回顾 | | parse-pgn-into-fens | 将 PGN 转换为 FEN 局面列表 |

可用提示

| 提示 | 描述 | |--------|-------------| | analyze-position | 全面的局面分析 |

谜题训练特性

ChessAgine MCP 现在可以访问 Lichess 广泛的谜题数据库，具有以下特点：

• 300 多万个谜题：适合所有水平的战术问题。
• 150 多种主题：包括牵制、闪击、串击、将杀模式、残局等。
• 等级过滤：找到适合你水平的谜题（500 - 3000+）。
• 主题组合：同时查询多个主题。
• 即时反馈：通过引擎分析验证解决方案。

热门谜题主题

• 战术主题：牵制、闪击、串击、发现攻击、引离。
• 将杀模式：一步杀、两步杀、三步杀、后翼杀、闷杀。
• 残局技巧：兵残局、车残局、后残局、升变。
• 战略元素：逼和、腾挪、干扰、吸引。

棋局回顾系统

新的棋局回顾系统提供全面的分析：

• 主题进展：跟踪子力、子力机动性、空间、局面处理和王的安全性。
• 关键时刻：自动识别棋局中的转折点。
• 可视化分析：生成主题演变的图表。
• 格式选项：JSON 数据或人类可读的文本报告。
• 可配置阈值：调整检测关键时刻的灵敏度。

API 集成

该服务器与多个国际象棋 API 集成：

• Lichess 探索者 API：开局统计数据和大师棋局。
• Lichess 谜题 API：拥有 300 多万个局面的战术谜题数据库。
• Lichess 棋局 API：用户棋局历史和特定棋局获取。
• ChessDB API：局面分析和着法数据库。
• Stockfish API：引擎评估和分析。

🔧 技术细节

从源代码构建

npm run build:mcp  # 构建项目
npm run dev        # 开发模式，实时监听文件变化
npm run clean      # 清理构建目录

🤝 贡献

1. 分叉仓库。
2. 创建一个功能分支 (git checkout -b feature/amazing-feature)。
3. 提交你的更改 (git commit -m 'Add amazing feature')。
4. 推送到该分支 (git push origin feature/amazing-feature)。
5. 打开一个拉取请求。

🛠️ 支持

• Discord：加入 ChessAgine 社区
• GitHub 问题：报告错误或请求功能
• 文档：完整文档

📄 许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• Stockfish：强大的国际象棋引擎，为分析提供支持。
• Lichess：开源国际象棋平台，提供棋局数据和谜题。
• ChessDB：全面的国际象棋局面数据库。
• Anthropic：模型上下文协议规范和工具。

👨‍💻 作者

@jalpp