Minecraft RCON MCP server

This MCP server allows AI assistants to interact with your Minecraft Docker server through RCON commands. It enables AI clients like Claude Desktop, Cursor, and Zed to programmatically control and create builds in your Minecraft world.

Prerequisites

Before you can use the MCP server, you need:

• A running Minecraft server in a Docker container named mc
• RCON enabled and properly configured

You can start a Minecraft server with the following command:

docker run -d --name mc -p 25565:25565 -e EULA=TRUE itzg/minecraft-server

Verifying RCON Access

To verify that RCON is working properly, test it with:

docker exec -it mc rcon "list"

If you receive a response, RCON is working correctly. If not, please check the itzg/docker-minecraft-server documentation for troubleshooting.

Installation

To install the MCP server for Minecraft Docker:

1. Clone the repository
2. Install the RCON tool using the MCP CLI:

mcp install rcon.py

Connecting to AI Clients

The MCP server integrates with AI clients like Claude Desktop, giving them the ability to send commands to your Minecraft server.

Once installed, AI assistants can execute Minecraft commands through RCON. For example, they can:

• List online players
• Change game settings
• Create complex structures and builds
• Manage server properties

Usage Examples

Basic Command Execution

AI clients can execute standard Minecraft commands:

/gamemode creative @p
/time set day
/weather clear

Creating Structures

AI assistants can programmatically create complex builds:

/fill ~0 ~0 ~0 ~10 ~5 ~10 minecraft:stone
/setblock ~5 ~1 ~5 minecraft:redstone_block

Player Management

/op username
/gamemode survival username
/tp username 100 64 100

The server uses the Minecraft container's built-in RCON functionality, making it compatible with any AI system that supports the Model Context Protocol.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.