ReyxGPT: Minecraft Server Management Agent

by ChrisMethsillo

319 downloads Not rated yet
GitHub

About

Minecraft server manager using the Model Context Protocol.

Explore

- 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

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.

uv run main.py

This will start the MCP server, allowing the agent to interact with your Minecraft 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 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.