Minecraft RCON MCP Server
About
a tiny minecraft mcp server, using the rcon interface
Details
- Author
- deemkeen
- Downloads
- 456
- Categories
- Other
Jump to
- Bridges MCP to a Minecraft server via the RCON protocol.
- Provides a sendCommand tool for sending Minecraft commands.
- Configuration via environment variables or a .env file.
- Built with Spring Boot and Spring AI for MCP integration.
- Requires a Minecraft server with RCON enabled.
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Minecraft RCON MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Build the project with Maven and Java 21+. Configure required environment variables RCON_HOST, RCON_PORT, and RCON_PASSWORD. Then add the built JAR to an MCP Client. The server exposes a tool called sendCommand that accepts a Minecraft command and returns the server’s response.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"minecraft rcon mcp server": {
"minecraft-rcon-mcp": {
"command": "/path/to/java",
"args": [
"-jar",
"/path/to/jar"
],
"env": {
"RCON_HOST": "<minecraft server host>",
"RCON_PORT": "<rcon port>",
"RCON_PASSWORD": "<rcon password>"
}
}
}
}
}McpServers
{
"minecraft-rcon-mcp": {
"command": "/path/to/java",
"args": [
"-jar",
"/path/to/jar"
],
"env": {
"RCON_HOST": "<minecraft server host>",
"RCON_PORT": "<rcon port>",
"RCON_PASSWORD": "<rcon password>"
}
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
