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 /tps and /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

1. Download the latest .jar from the Versions tab and drop it into your plugins/ folder.
2. Restart your server.
3. Configure plugins/MCPMinecraft/config.yml with a secure token and port.
4. 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.