ReyxGPT: Minecraft Server Management Agent

ReyxGPT：Minecraft 服务端管理 Agent

ReyxGPT 是一个使用 FastMCP 3 构建、用于通过 RCON 管理 Minecraft 服务端的 MCP 服务。

工具

服务端控制

工具	描述
execute_minecraft_command	在服务端运行任意命令
execute_batch_commands	按顺序运行多条命令
check_server_status	获取 TPS 和版本信息

玩家

工具	描述
get_online_players	列出已连接的玩家
get_player_location	获取玩家的 XYZ 坐标
teleport_player	将玩家传送到指定坐标

命令信息

工具	描述
list_commands	列出全部约 80 条 Java 版命令（可按类别筛选）
get_command_info	获取任意命令的语法、op 等级和描述
search_commands	按关键词搜索命令
fetch_command_wiki	从 Minecraft Wiki API 获取实时文档
get_server_command_help	向服务端查询 /help <command>

设置

将 .env.example 复制为 .env，并填写 RCON 凭据：

cp .env.example .env

确保在 server.properties 中启用 RCON：

enable-rcon=true
rcon.port=25575
rcon.password=yourpassword

运行

stdio（用于 Claude Desktop、Cursor 等）：

uv run reyxgpt

HTTP（用于网络客户端或多客户端设置）：

uv run reyxgpt --transport http --host 0.0.0.0 --port 8000

MCP 端点：http://localhost:8000/mcp
健康检查：http://localhost:8000/health

SSE（旧版）：

uv run reyxgpt --transport sse --port 8000

MCP 客户端配置

Claude Desktop / Cursor（stdio）

"mcpServers": {
  "reyxgpt": {
    "command": "uv",
    "args": ["--directory", "/ABSOLUTE/PATH/TO/ReyxGPT", "run", "reyxgpt"],
    "env": {
      "RCON_HOST": "localhost",
      "RCON_PORT": "25575",
      "RCON_PASSWORD": "yourpassword"
    }
  }
}

HTTP 传输

"mcpServers": {
  "reyxgpt": {
    "url": "http://localhost:8000/mcp"
  }
}

项目结构

src/reyxgpt/
├── __init__.py         # exports mcp, registers all tools
├── __main__.py         # CLI entry point (--transport, --host, --port)
├── server.py           # FastMCP instance + lifespan + /health route
├── rcon.py             # RCONServer client
├── data/
│   └── commands.json   # ~80 Java Edition commands database
└── tools/
    ├── commands.py     # execute_minecraft_command, execute_batch_commands
    ├── players.py      # get_online_players, get_player_location, teleport_player
    ├── status.py       # check_server_status
    └── info.py         # list_commands, get_command_info, search_commands,
                        # fetch_command_wiki, get_server_command_help

要求

• Python 3.10+
• uv
• 启用 RCON 的 Minecraft Java 版服务端