Skip to content

chrism3th/ReyxGPT

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

Minecraft server manager using the Model Context Protocol.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages