mcpField
M
Minecraft RCON MCP Server

Minecraft RCON MCP Server

Local
github.com/deemkeenGames & Entertainment0Updated 82w ago

About Minecraft RCON MCP Server

Minecraft RCON MCP Server is a Spring Boot application for AI models that bridges MCP with a Minecraft server's RCON interface. Its `sendCommand` tool sends Minecraft commands and returns server responses.

Key features

  1. 01RCON connection to Minecraft
  2. 02Send Minecraft commands
  3. 03Return server responses
  4. 04Configure connection with environment variables

Use cases

  1. 01Send commands to a Minecraft server from an AI model
  2. 02Query a server and inspect its responses

MCP support

It exposes a `sendCommand` tool to MCP clients, which forwards commands through RCON and returns the Minecraft server's response.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Minecraft RCON MCP Server

A Spring Boot application that provides a bridge between Model Context Protocol (MCP) and a Minecraft server's RCON interface, allowing AI models to send commands to a Minecraft server. Built with SpringAI.

Description

This project enables AI models using Spring AI's MCP functionality to interact with a Minecraft server through the RCON protocol. It provides a simple tool that can send commands to the Minecraft server and receive responses, making it possible for AI models to control and query the Minecraft server.

Prerequisites

  • Java 21 or higher
  • Maven 3.6 or higher
  • A Minecraft server with RCON enabled

Building the Project

  1. Clone the repository:

    git clone https://github.com/yourusername/minecraft-rcon-mcp.git
    cd minecraft-rcon-mcp
    
  2. Build the project using Maven:

    ./mvnw clean package
    

    On Windows:

    mvnw.cmd clean package
    
  3. The built JAR file will be located in the target directory:

    target/minecraft-rcon-mcp-1.0.0.jar
    

Configuration

The application can be configured using environment variables or a .env file in the project root directory.

Required Env Param Configuration
  • RCON_HOST: The hostname or IP address of the Minecraft server (default: localhost)
  • RCON_PORT: The RCON port of the Minecraft server (default: 25575)
  • RCON_PASSWORD: The RCON password for authentication (required, no default)
Optional Configuration
  • logging.file.name: The name of the log file (default: rconmcp.log)

Usage

Once the application is built and added to an MCP Client with your Env-Params, it exposes a Model Context Protocol (MCP) server that can be used by Spring AI clients to send commands to the Minecraft server.

The MCP server provides a tool called sendCommand that takes a Minecraft command as input and returns the response from the server.

License

MIT License

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.