MCP Fiar

🚀 四目並べ - MCPゲーム

Spring Bootを使用してModel Context Protocol (MCP) サーバーとして実装された四目並べスタイルのゲームです。本ゲームでは、プレイヤーがGitHub Copilotと対戦し、縦横斜めに4つの駒を並べることを目指します。

🚀 クイックスタート

このプロジェクトは、Spring Bootを使用して構築されたModel Context Protocol (MCP)サーバーとして、四目並べゲームを実装しています。プレイヤーはGitHub Copilotと対戦し、縦横斜めに4つの駒を並べることが目的です。

✨ 主な機能

• Spring Bootを使用したMCPサーバーとしての四目並べゲームの実装。
• プレイヤーがGitHub Copilotと対戦できるクラシックな縦並びチェッカーゲーム。
• 水平、垂直、または斜めに4つの駒を並べることで勝利する。

📦 インストール

前提条件

• 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構成ファイル (mcp.json が .vscode フォルダにあります) が含まれており、サーバーを簡単に起動できます。

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」ボタンをクリックします。これにより、GitHub Copilotが対話するためのMCPサーバーが起動します。

ゲームのプレイ

サーバーが起動したら、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つの駒を横、縦、または斜めに並べたプレイヤーが勝ちます。
4. すべての位置が埋まっても勝者が決まらない場合は、ゲームは引き分けとなります。

開発に関する注意事項

このプロジェクトは以下を使用しています。

• アプリケーションフレームワークとしてSpring Boot
• GitHub Copilotとの通信にSpring AI Model Context Protocol (MCP)
• テストにJUnit

ゲームを拡張または変更する場合は、主なクラスは次のとおりです。

• FiarServiceImpl.java - コアゲームロジックが含まれています。
• Game.java - ゲーム状態を表します。

参考資料

• Spring AI MCP Documentation - Spring AI Model Context Protocolの公式ドキュメント
• Spring Boot Documentation - Spring Bootフレームワークのリファレンス
• GitHub Copilot Documentation - GitHub Copilotの機能に関する情報