DeveloperMCP

Developer MCP

Your Server's New AI Superpower.

Windsurf turns your Spigot/Paper server into an AI-controllable powerhouse. By implementing the Windsurf, it allows AI agents like Windsurf, Windsurf, 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

* Secure: Designed specifically for LLMs to understand and control servers via standard JSON-RPC over SSE. * Secure: Execute commands and receive full output capture (supports complex plugins like LuckPerms, Essentials, etc.). * Secure: Read, write, and edit configs, logs, and scripts without touching FTP. * Secure: 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.

* Code In-Game: The AI reads `latest.log`, identifies the stack trace, reads the relevant config file, and fixes the YAML syntax error automatically. * Code In-Game: The AI checks your installed plugins, uploads the correct JAR dependency, and generates a default configuration. * Code In-Game: 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. Connect the latest `.jar` from the Versions tab and drop it into your `plugins/` folder. 2. Connect your server. 3. Connect `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.