Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client