Minecraft RCON MCP Server

Minecraft RCON MCP サーバー

Model Context Protocol（MCP）と Minecraft サーバーの RCON インターフェースをつなぎ、AI モデルが Minecraft サーバーにコマンドを送信できる Spring Boot アプリケーションです。SpringAI を使用して構築されています。

説明

このプロジェクトを使うと、Spring AI の MCP 機能を使用する AI モデルが、RCON プロトコル経由で Minecraft サーバーとやり取りできます。Minecraft サーバーにコマンドを送信し、応答を受け取るシンプルなツールを提供するため、AI モデルによる 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 クライアントに追加すると、Spring AI クライアントから Minecraft サーバーへのコマンド送信に利用できる Model Context Protocol（MCP）サーバーが公開されます。

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

ライセンス

MIT ライセンス