home / mcp / minecraft mcp server

Minecraft MCP Server

Exposes console control, file operations, plugin info, and logs over HTTP for Spigot and Paper servers.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "center2055-minecraftdevelopermcp": {
      "url": "http://YOUR-SERVER-IP:25374/sse?token=YOUR-SECURE-TOKEN"
    }
  }
}

MCP Minecraft bridge lets you manage Spigot and Paper servers over HTTP. It exposes console access, file reads/writes, plugin info, and log retrieval so you can automate server administration without FTP or screen sharing.

How to use

You connect a client to your server using the MCP HTTP endpoint. Provide the server URL and a token to gain access to console commands, file operations, plugin details, and logs. Once connected, you can run commands, inspect and modify files, upload or download binaries, and monitor server activity. All actions are performed through a single, secure interface designed for automation and scripting.

How to install

Prerequisites you need on the server host before enabling MCP access:

Step 1. Install the MCP plugin on your Spigot or Paper server by placing the MCP JAR into your plugins/ folder.

Step 2. Start the server once to generate the configuration file, then open the generated config to adjust security and network settings.

Configuration and security

In the active configuration, you typically set a port and a secure token. Choose an open port and ensure your host firewall allows traffic to that port. Protect the token because anyone with it can access the console.

Connect an MCP client

Use the following MCP endpoint to connect: http://YOUR-SERVER-IP:25374/sse?token=YOUR-SECURE-TOKEN. This is the primary method for remote control and automation over SSE.

Build from source

git clone https://github.com/center2055/MinecraftDeveloperMCP.git
cd MinecraftDeveloperMCP
mvn clean package

Notes on usage

If you need to access logs, you can fetch the last 100 lines from logs/latest.log. You can also read or edit text files within the server directory, upload or download binary files via base64 encoding, and list or inspect plugins and their versions.

Available tools

execute_command

Run any server console command and capture its output.

read_file

Read any text file inside the server directory.

write_file

Create or edit text files in place within the server directory.

list_plugins

List installed plugins along with their versions.

get_logs

Fetch the last 100 lines from the server's latest.log file.

write_file_base64

Upload binary files to the server by encoding them in base64.

read_file_base64

Download binary files from the server as base64.

list_directory

List files in a directory with their sizes.