Minecraft Rcon MCP

🚀 Minecraft RCON MCP 服務器

這是一個基於 Spring Boot 的應用程序，作為 Model Context Protocol (MCP) 和 Minecraft 服務器 RCON 接口的橋樑，藉助 SpringAI 開發，讓 AI 模型能向 Minecraft 服務器發送命令。

🚀 快速開始

本項目可使運用 Spring AI 的 MCP 功能的 AI 模型，通過 RCON 協議與 Minecraft 服務器進行交互。它提供了簡便工具，能向 Minecraft 服務器發送命令並接收響應，進而讓 AI 模型實現對 Minecraft 服務器的控制與查詢。

✨ 主要特性

• 作為 MCP 和 Minecraft 服務器 RCON 接口的橋樑，實現 AI 模型與 Minecraft 服務器的交互。
• 藉助 SpringAI 開發，提供簡單工具用於發送命令和接收響應。

📦 安裝指南

先決條件

• 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