ReyxGPT: Minecraft Server Management Agent

ReyxGPT：Minecraft サーバー管理エージェント

ReyxGPT は、RCON 経由で Minecraft サーバーを管理するために FastMCP 3 で構築された MCP サーバーです。

ツール

サーバー制御

ツール	説明
execute_minecraft_command	サーバー上で任意のコマンドを実行します
execute_batch_commands	複数のコマンドを順番に実行します
check_server_status	TPS とバージョン情報を取得します

プレイヤー

ツール	説明
get_online_players	接続中のプレイヤーを一覧表示します
get_player_location	プレイヤーの XYZ 座標を取得します
teleport_player	プレイヤーを指定した座標にテレポートさせます

コマンド情報

ツール	説明
list_commands	Java Edition の約 80 個のコマンドを一覧表示します（カテゴリで絞り込み可能）
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 Edition サーバー