Minecraft RCON MCP 服务器

一个基于Spring Boot的应用程序,提供Model Context Protocol (MCP)与Minecraft服务器RCON接口之间的桥梁,允许AI模型向Minecraft服务器发送命令。

  • by deemkeen
  • Java
  • 本地部署
  • 更新于
在 GitHub 查看 deemkeen/minecraft-rcon-mcp

使用说明

Minecraft RCON MCP服务器

一个Spring Boot应用程序,在模型上下文协议(MCP)和Minecraft服务器的RCON接口之间提供桥梁,允许AI模型向Minecraft服务器发送命令。使用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客户端,它就会暴露一个模型上下文协议(MCP)服务器,Spring AI客户端可以使用该服务器向Minecraft服务器发送命令。

MCP服务器提供了一个名为 sendCommand 它接收Minecraft命令作为输入,并从服务器返回响应。

许可证

MIT许可证