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

📚 詳細文檔

可用工具

可用提示

謎題訓練特性

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