Minecraft Rcon MCP

🚀 Minecraft RCON MCP サーバー

このアプリケーションはSpring Bootをベースに開発されており、Model Context Protocol (MCP) とMinecraftサーバーのRCONインターフェースの橋渡しを行い、AIモデルがMinecraftサーバーにコマンドを送信できるようにします。SpringAIを使用して開発されています。

🚀 クイックスタート

このプロジェクトでは、Spring AIのMCP機能を利用したAIモデルが、RCONプロトコルを通じてMinecraftサーバーとやり取りできるようになります。簡単なツールを提供し、Minecraftサーバーにコマンドを送信して応答を受け取ることができ、AIモデルがMinecraftサーバーを制御およびクエリすることが可能です。

✨ 主な機能

• Spring Bootベースのアプリケーションで、MCPとMinecraftサーバーのRCONインターフェースを接続します。
• AIモデルがMinecraftサーバーにコマンドを送信できるようにします。
• MCPサーバーが提供する sendCommand ツールで、Minecraftコマンドを入力してサーバーからの応答を取得できます。

📦 インストール

前提条件

• Java 21以上
• Maven 3.6以上
• RCONが有効になっているMinecraftサーバー

プロジェクトのビルド

1. リポジトリをクローンします:

   git clone https://github.com/yourusername/minecraft-rcon-mcp.git
   cd minecraft-rcon-mcp
   

2. Mavenを使用してプロジェクトをビルドします:

   ./mvnw clean package
   

   Windowsの場合は:

   mvnw.cmd clean package
   

3. ビルドされたJARファイルは target ディレクトリにあります：

   target/minecraft-rcon-mcp-1.0.0.jar
   

📚 ドキュメント

設定

アプリケーションは、環境変数またはプロジェクトのルートディレクトリにある .env ファイルを使用して設定できます。

必須環境変数設定

• RCON_HOST: Minecraftサーバーのホスト名またはIPアドレス（デフォルト：localhost）
• RCON_PORT: MinecraftサーバーのRCONポート（デフォルト：25575）
• RCON_PASSWORD: RCON認証パスワード（必須、デフォルト値なし）

オプション設定

• logging.file.name: ログファイルの名前（デフォルト：rconmcp.log）

使用方法

ビルドが完了したら、アプリケーションをMCPクライアントに追加し、環境変数を指定すると、MCPサーバーが公開され、Spring AIクライアントがこのサーバーを使用してMinecraftサーバーにコマンドを送信できます。

MCPサーバーは sendCommand というツールを提供しており、これはMinecraftコマンドを入力として受け取り、サーバーからの応答を返します。

📄 ライセンス

MIT License