DeveloperMCP
Turn your Minecraft server into an AI-controllable powerhouse. Control Spigot/Paper servers directly from Cursor/Claude via Model Context Protocol (MCP).
Developer MCP
Your Server's New AI Superpower.
Developer MCP turns your Spigot/Paper server into an AI-controllable powerhouse. By implementing the Model Context Protocol (MCP), it allows AI agents like Claude Desktop, Cursor, and Windsurf to directly interact with your server in real-time.
Stop alt-tabbing between your IDE, console, and FTP client. Just ask your AI to do it.
⚡ Key Features
- AI-Native Integration: Designed specifically for LLMs to understand and control servers via standard JSON-RPC over SSE.
- Live Console Access: Execute commands and receive full output capture (supports complex plugins like LuckPerms, Essentials, etc.).
- Full File Management: Read, write, and edit configs, logs, and scripts without touching FTP.
- Binary Support: Upload JARs or download world data directly via Base64 transfer.
- Secure: Token-based authentication ensures only YOU (and your AI) have control.
🛠️ Capabilities
Imagine having a senior developer sitting inside your server console, 24/7.
- Debug Errors: The AI reads
latest.log, identifies the stack trace, reads the relevant config file, and fixes the YAML syntax error automatically. - Setup Plugins: The AI checks your installed plugins, uploads the correct JAR dependency, and generates a default configuration.
- Monitor Performance: The AI runs
/tpsand/timings, analyzes the output, and suggests specific optimizations. - Code In-Game: The AI writes a Skript or Java plugin and hot-loads it instantly.
🧩 Supported Tools
The plugin exposes these tools to your connected AI:
| Tool | Description |
|---|---|
execute_command | Run console commands with output capture. |
read_file | Read text files (configs, logs, scripts). |
write_file | Create or edit text files. |
list_directory | Explore folders and view file sizes. |
read_file_base64 | Download binary files (e.g., world data). |
write_file_base64 | Upload binary files (e.g., plugin JARs). |
list_plugins | Get a clean version list of all plugins. |
get_logs | Quick access to recent log entries. |
🚀 Installation
- Download the latest
.jarfrom the Versions tab and drop it into yourplugins/folder. - Restart your server.
- Configure
plugins/MCPMinecraft/config.ymlwith a secure token and port. - Connect your AI client (e.g., Cursor) by adding the server details to
mcp.json.
{ "mcpServers": { "server-control": { "url": "http://YOUR-IP:PORT/sse?token=YOUR-TOKEN", "transport": "sse" } } }---
🔒 Security Note
This plugin provides complete administrative control over your server.
- Use a strong, random token (generated in your config).
- Do not expose the configured port to the public internet unless you have firewall rules restricting access to your specific IP.
