?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
DeveloperMCP

DeveloperMCP

Turn your Minecraft server into an AI-controllable powerhouse. Control Spigot/Paper servers directly from Cursor/Claude via Model Context Protocol (MCP).

19
1

Compatibility

Minecraft: Java Edition

1.21–1.21.10
1.20.x

Platforms

Links

Report issues View source Join Discord server

Creators

center2055
center2055Member

Details

Licensed ARR
Published 2 weeks ago
Updated 2 days ago

Developer MCP

Java Spigot/Paper 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.