CommandNeural is a PaperMC plugin that exposes an MCP (Model Context Protocol) HTTP server on your Minecraft server. MCP-compatible clients and AI agents can use this endpoint to execute 100+ administration tools over HTTP.

What is MCP? MCP is a protocol standard for connecting AI assistants to external tools. This plugin implements the MCP server side, exposing Minecraft server operations as callable tools.

Features:

• Server management — run commands, read logs, view server info, schedule tasks
• Player management — list, kick, ban, teleport, give items, manage inventories
• World editing — set blocks, change time/weather, spawn entities, create explosions
• Construction — fill, replace, clone, build shapes, WorldEdit schematic support
• Plugin integrations (16 detected): WorldGuard regions, LuckPerms permissions, Vault economy, PlaceholderAPI, Oraxen items, Citizens NPCs, CoreProtect, EssentialsX, GriefPrevention, MythicMobs, DiscordSRV, UnlimitedNameTags, and more
• File system access — read, write, edit, search, download (sandboxed to server directory)
• Database queries — execute SQL via JDBC
• NBT manipulation — modify item and entity NBT data

Security:

• Token-based authentication
• Per-IP rate limiting
• Per-tool permission toggles (configurable in config.yml)
• File sandbox restricts operations to server root
• Command blacklist for dangerous commands
• Full-access mode (disabled by default, bypasses all permission checks)
• TLS/HTTPS support with auto-generated self-signed keystore

Compatibility:

• Paper 1.16.5+ (Java 21)
• Folia (auto-detected via reflection)
• Also works on Purpur and Spigot

How to use:

1. Place the JAR in your plugins/ folder
2. Start the server to generate plugins/CommandNeural/config.yml
3. Configure your auth token in config.yml
4. Connect from any MCP-compatible client to http://your-server:8765/mcp