Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"minecraftservermcp": {
"command": "<see-readme>",
"args": []
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Javadoc: v1.0.1
No automated test available for this server. Check the GitHub README for setup instructions.
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
No package registry to scan.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in entertainment
The official MCP Server for the Mux API
MCP Server for Text to Speech
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Unity MCP Server — 268 tools for AI-assisted game development. Connect Claude, Cursor, or any MCP client to Unity Editor & Unity Hub. Scene management, GameObjects, components, builds, profiling, Shader Graph, Amplify, terrain, physics, NavMesh, animation, MPPM multiplayer & more. Free & open source by AnkleBreaker Studio.
MCP Security Weekly
Get CVE alerts and security updates for MinecraftServerMCP and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Javadoc: v1.0.1
Spigot/Paper plugin that runs an embedded Model Context Protocol server over HTTP(S): tools and resources for the world directory, console, logs, and players, gated by bearer tokens and per-tool policies. Uses the MCP Java SDK (streamable HTTP).
X-MCP-Token; per-profile YAML under access.<profile>.tools.<toolId>fs_read, fs_list, fs_write, server_command, server_logs, players_list, player_getMinecraftServerMcp/mcp reload reloads tokens and policies (does not unregister tools)| Version | |
|---|---|
| Paper or Spigot | 1.21+ |
| Java | 21 |
*-plain.jar) into plugins/.plugins/MinecraftServerMCP/config.yml.access.<name>.token to a long random secret. The plugin disables itself if no tokens are configured.http://<host>:<port><mcpPath> (defaults: 8765, /mcp) with header Authorization: Bearer <token> or X-MCP-Token: <token>.bindAddress: "127.0.0.1" unless the client runs on another machine. Optional HTTPS is configured under ssl (requires a full restart to change).Example listener + token:
bindAddress: "127.0.0.1"
port: 8765
mcpPath: "/mcp"
access:
prod:
token: "<use openssl rand -hex 32 or similar>"
Full keys: see config.yml (inline comments).
Don't forget to update the URL and credentials.
{
"mcpServers": {
"minecraft-server-mcp": {
"url": "http://127.0.0.1:8765/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
Policy YAML: access.<profile>.tools.<id>.
| Id | Type | Notes |
|---|---|---|
fs_read | Resource | minecraft-server-mcp://fs/read{?path} |
fs_list | Resource | minecraft-server-mcp://fs/list{?path} |
fs_write | Tool | |
server_command | Tool | commandWhitelist / commandBlacklist |
server_logs | Tool | maxLogLines, maxLogBytes, … |
players_list | Resource | minecraft-server-mcp://players/list |
player_get | Resource | minecraft-server-mcp://player/get{?name} |
Use a prefix on custom tool names (e.g. myplugin_action) so they do not collide with built-ins.
API reference: Javadoc v1.0.1 (MinecraftServerMcp, built-ins, config types).
plugin.yml:
name: MyPlugin
# ...
softdepend: [MinecraftSer
... [View full README on GitHub](https://github.com/MrApik/MinecraftServerMCP#readme)