MCP Fiar

🚀 四子連珠 - MCP 遊戲

這是一個基於 Spring Boot 實現的四子連珠（Connect Four）風格的遊戲，以模型上下文協議（Model Context Protocol，MCP）服務器的形式呈現。玩家可以在經典的垂直跳棋遊戲中與 GitHub Copilot 一決高下，目標是在水平、垂直或對角方向上連成四個棋子。

🚀 快速開始

本項目以 模型上下文協議 (MCP) 服務器的形式實現了四子連珠（也稱為 Connect Four）遊戲，該服務器使用 Spring Boot 構建。遊戲允許玩家在經典的垂直跳棋遊戲中與 GitHub Copilot 競爭，目標是在水平、垂直或對角方向上連成四個棋子。

✨ 主要特性

• 實現經典的四子連珠遊戲玩法。
• 支持與 GitHub Copilot 對戰。
• 提供多種遊戲指令，方便玩家操作。

📦 安裝指南

前提條件

• Java JDK 17 或更高版本
• Maven 3.6 或更高版本
• 安裝了 GitHub Copilot 擴展的 Visual Studio Code

安裝步驟

1. 克隆倉庫：

   git clone <repository-url>
   cd mcp-fiar
   

2. 使用 Maven 構建項目：

   ./mvnw clean install
   

   這將在 target/mcp-fiar-0.0.1-SNAPSHOT.jar 處創建 JAR 文件。

💻 使用示例

啟動 MCP 服務器

項目包含一個 VS Code MCP 配置文件（.vscode 文件夾中的 mcp.json），可輕鬆啟動服務器：

1. 在 Visual Studio Code 中打開項目。
2. 確保已安裝並啟用 GitHub Copilot Chat 擴展。
3. 打開命令面板（Cmd + Shift + P 或 Ctrl + Shift + P）。
4. 輸入並選擇：“Copilot: Open Chat”。
5. 與 Copilot Chat 交互時，MCP 服務器應自動啟動。

如果服務器未自動啟動，請確保 .vscode/mcp.json 文件中的 MCP 配置正確設置：

{
  "servers": {
    "fiar-game-mcp-weather": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "${workspaceFolder}/target/mcp-fiar-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

將鼠標懸停在服務器條目上，點擊出現的“Start Server”按鈕，這將啟動 MCP 服務器，以便 GitHub Copilot 與之交互。

開始遊戲

服務器運行後，可與 GitHub Copilot 交互來玩遊戲：

1. 在 GitHub Copilot Chat 面板中，輸入如下提示：

   • “Let's play Four in a Row”
   • “Start a Four in a Row game with a 6×6 grid”
   • “Can we play Connect Four with a 5×5 board?”

2. Copilot 將創建新遊戲並作為對手。

3. 要進行移動，只需回覆要放置棋子的列號（標準棋盤為 1 - 7）。

4. Copilot 將進行移動，並在每輪後顯示更新後的棋盤。

遊戲指令

以下是遊戲過程中可用的一些有用提示：

• 1 到 7 - 將棋子放入指定列
• “Show me the board” - 顯示當前棋盤狀態
• “Reset all games” - 清除所有已存儲的遊戲
• “Get all games” - 列出所有活躍和已完成的遊戲

📚 詳細文檔

項目結構

項目結構如下：

• src/main/java/com/microsoft/germany/csu/mcp_fiar/ - 核心應用代碼
  • McpFiarApplication.java - Spring Boot 應用程序入口點
  • service/api/ - API 接口和模型類
    • FiarService.java - 遊戲服務接口
    • Game.java - 遊戲狀態模型
    • GameStatus.java - 遊戲狀態枚舉（IN_PROGRESS、PLAYER_ONE_WON 等）
  • service/impl/ - 服務實現
    • FiarServiceImpl.java - 遊戲邏輯實現

遊戲規則

1. 玩家輪流將棋子放入其中一列。
2. 棋子落入所選列的最低可用位置。
3. 第一個在水平、垂直或對角方向上連成四個棋子的玩家獲勝。
4. 如果所有位置都被填滿且沒有獲勝者，則遊戲平局。

開發說明

本項目使用：

• Spring Boot 作為應用程序框架
• Spring AI 模型上下文協議 (MCP) 與 GitHub Copilot 通信
• JUnit 進行測試

若要擴展或修改遊戲，主要查看以下類：

• FiarServiceImpl.java - 包含核心遊戲邏輯
• Game.java - 表示遊戲狀態

🔧 技術細節

本項目藉助 Spring Boot 框架搭建應用程序，利用 Spring AI 模型上下文協議（MCP）實現與 GitHub Copilot 的通信，同時採用 JUnit 進行測試。在代碼實現方面，FiarServiceImpl.java 類承擔了核心的遊戲邏輯，包括玩家落子、判斷勝負等操作；Game.java 類則負責維護遊戲的狀態信息。通過這些技術和代碼結構，確保了遊戲的穩定運行和良好的交互體驗。

📄 許可證

文檔未提及相關信息，故跳過該章節。

📖 參考資源

• Spring AI MCP 文檔 - Spring AI 模型上下文協議的官方文檔
• Spring Boot 文檔 - Spring Boot 框架參考
• GitHub Copilot 文檔 - 關於 GitHub Copilot 功能和能力的信息