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