返回 MCP 目录
public公开dns本地运行

ReyxGPT

ReyxGPT是一个基于MCP协议的Minecraft服务器管理代理,通过RCON实现服务器命令执行和状态监控。

article

README

🚀 ReyxGPT:用于Minecraft服务器管理的代理

ReyxGPT是一款基于Model Context Protocol (MCP)构建的代理工具,借助RCON协议实现对Minecraft服务器的高效管理。它赋予语言模型强大能力,可执行服务器命令,还能实时监控服务器与玩家的状态。

🚀 快速开始

ReyxGPT可与Claude Desktop等客户端集成,以下是集成的具体步骤:

  1. 在您的MCP配置中添加如下内容:
"mcpServers": {
  "reyxgpt": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\\ABSOLUTE_PATH\\",
      "run",
      "main.py"
    ],
    "env": {
      "RCON_HOST": "localhost",
      "RCON_PORT": "25575",
      "RCON_PASSWORD": "verysecurepassword"
    }
  }
}
  1. 确保您的Minecraft服务器已启用RCON功能,并使用上述指定的凭据进行配置。

📦 安装指南

系统要求

  • Python 3.13
  • uv 用于运行项目

启动代理

在满足系统要求后,执行以下命令启动代理:

uv run main.py

此命令将启动MCP服务器,让代理与您的Minecraft服务器实现交互。

🔧 技术细节

项目结构

ReyxGPT项目的结构清晰,各部分分工明确,具体如下:

ReyxGPT/
├── .env                 # RCON配置
├── main.py              # 应用程序入口
├── mcp_server/          # MCP服务器实现
├── rcon/                # RCON客户端实现
├── pyproject.toml       # 依赖项和元数据
└── uv.lock              # 依赖锁定文件

各部分的具体作用:

  • .env:存储RCON的相关配置信息。
  • main.py:作为应用程序的入口,负责启动整个项目。
  • mcp_server/:实现了MCP服务器的核心功能。
  • rcon/:包含了RCON客户端的实现代码。
  • pyproject.toml:记录项目的依赖项和元数据。
  • uv.lock:锁定项目的依赖版本,确保环境的一致性。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端