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.

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.