What is MinecraftServerMCP?

MinecraftServerMCP is a Spigot/Paper plugin that embeds a Model Context Protocol (MCP) server directly within your Minecraft server, enabling HTTP(S) access to server resources.

What server resources can be accessed via MinecraftServerMCP?

You can securely access and manage various resources including filesystem operations (read, list, write), server command execution, log access, and player management (list, get player info).

How does MinecraftServerMCP ensure secure access?

Access is secured using bearer tokens or `X-MCP-Token` headers. It also features robust per-profile and per-tool policy controls, allowing fine-grained permissions for each client.

Can other Spigot/Paper plugins extend MinecraftServerMCP's functionality?

Yes, MinecraftServerMCP provides a public API that allows other Spigot/Paper plugins to register their own custom MCP tools and resources, seamlessly integrating new functionalities.

What are the core requirements to run MinecraftServerMCP?

To run MinecraftServerMCP, your server must be running Paper or Spigot version 1.21 or newer, and your server's Java environment must be Java 21.

MinecraftServerMCP: Secure HTTP(S) Access to Minecraft Server

MinecraftServer is a Spigot/Paper plugin designed to integrate a Model Context Protocol (MCP) server directly into Minecraft game servers. It provides a robust framework for external applications and tools to interact with the Minecraft server securely via HTTP(S). This includes access to vital server resources such as the file system, console commands, logs, and player data, all safeguarded by bearer tokens and granular per-tool policy controls. Developers can also extend its functionality by registering custom MCP tools, facilitating advanced server management and automation.

주요 기능

01Embedded MCP server over HTTP(S) with configurable bind address, port, and path.

02Secure access via bearer tokens or `X-MCP-Token` headers with per-profile, per-tool policy controls.

03Built-in tools and resources for file system operations (`fs_read`, `fs_list`, `fs_write`), server command execution, log access, and player management (`players_list`, `player_get`).

04API for other Spigot/Paper plugins to register custom MCP tools and resources.

05Runtime reloading of tokens and policies without requiring a server restart.

060 GitHub stars

사용 사례

01Remotely manage Minecraft server files, configurations, and console commands from external applications.

02Integrate custom dashboards or monitoring tools to display server logs and player statistics.

03Develop automation scripts for routine server maintenance, player interactions, or game event triggering.