ReyxGPT: Minecraft Server Management Agent

by ChrisMethsillo

319 downloads
Not rated
GitHub

About

Minecraft server manager using the Model Context Protocol.

Details

Author
ChrisMethsillo
Downloads
319
Categories
AI

- Execute Minecraft server commands via RCON.
- Monitor server and player status.
- Built on the Model Context Protocol (MCP).
- Uses the RCON protocol for communication.
- Runs with Python 3.13 and the uv package runner.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name ReyxGPT: Minecraft Server Management Agent
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure the server by adding a JSON entry to your MCP client configuration (e.g., Claude Desktop) with the RCON host, port, and password. Ensure your Minecraft server has RCON enabled. Then run uv run main.py to start the MCP server and allow the agent to interact with your server.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "reyxgpt: minecraft server management agent": {
            "ReyxGPT": {
                "command": "uv",
                "args": [
                    "run",
                    "main.py"
                ]
            }
        }
    }
}

McpServers

{
    "ReyxGPT": {
        "command": "uv",
        "args": [
            "run",
            "main.py"
        ]
    }
}

ReyxGPT: Minecraft Server Management Agent

ReyxGPT is an agent built on the Model Context Protocol (MCP) for managing Minecraft servers via RCON. It allows a language model to:

- Execute server commands
- Monitor server and player status

Setup

To integrate ReyxGPT with clients like Claude Desktop, add the following to your MCP configuration:

"mcpServers": {
  "reyxgpt": {
    "command": "uv",
    "args": [
      "--directory",
      "C:\\ABSOLUTE_PATH\\",
      "run",
      "main.py"
    ],
    "env": {
      "RCON_HOST": "localhost",
      "RCON_PORT": "25575",
      "RCON_PASSWORD": "verysecurepassword"
    }
  }
}

Ensure your Minecraft server has RCON enabled with the specified credentials.

Project Structure

ReyxGPT/
├── .env                 # RCON configuration
├── main.py              # Application entry point
├── mcp_server/          # MCP server implementation
├── rcon/                # RCON client implementation
├── pyproject.toml       # Dependencies and metadata
└── uv.lock              # Dependency lock file

Requirements

- Python 3.13
- uv for running the project

Running the Agent

uv run main.py

This will start the MCP server, allowing the agent to interact with your Minecraft server.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.