Minecraft RCON MCP Server

Minecraft RCON MCP Server

site icon
2025.04.06 0
JavaMinecraft 交互游戏控制娱乐功能
Minecraft RCON MCP Server 是一个基于 Spring Boot 的应用程序,它充当了模型上下文协议(MCP)和 Minecraft 服务器的 RCON 接口之间的桥梁。通过这个服务,AI 模型可以发送命令到 Minecraft 服务器,实现对游戏的控制和查询。该项目利用 SpringAI 构建,为 AI 模型提供了一个简单易用的工具来与 Minecraft 服务器交互。
View on GitHub

Overview

基本能力

产品定位

Minecraft RCON MCP Server 是一个中间件服务,旨在为 AI 模型提供与 Minecraft 服务器交互的能力。

核心功能

  • 提供 MCP 服务器,允许 Spring AI 客户端通过 MCP 协议与 Minecraft 服务器交互。
  • 提供 sendCommand 工具,用于发送 Minecraft 命令并接收服务器响应。
  • 支持通过环境变量或 .env 文件进行配置。

适用场景

  • AI 模型需要控制或查询 Minecraft 服务器的场景。
  • 自动化 Minecraft 服务器管理的场景。

工具列表

  • sendCommand: 发送 Minecraft 命令到服务器并返回响应。

常见问题解答

  • 确保 Minecraft 服务器已启用 RCON 并正确配置了 RCON 密码。
  • 确保环境变量 RCON_HOSTRCON_PORTRCON_PASSWORD 已正确设置。

使用教程

使用依赖

  • Java 21 或更高版本
  • Maven 3.6 或更高版本
  • 已启用 RCON 的 Minecraft 服务器

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/minecraft-rcon-mcp.git cd minecraft-rcon-mcp

  2. 使用 Maven 构建项目: bash ./mvnw clean package

在 Windows 上: bash mvnw.cmd clean package

  1. 构建完成后,JAR 文件位于 target 目录: target/minecraft-rcon-mcp-1.0.0.jar

调试方式

  • 确保 .env 文件或环境变量已正确配置。
  • 启动服务后,检查日志文件 rconmcp.log 以获取调试信息。

许可证

该项目遵循 MIT 开源许可条款。