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:
- Place the JAR in your
plugins/ folder
- Start the server to generate
plugins/CommandNeural/config.yml
- Configure your auth token in config.yml
- Connect from any MCP-compatible client to
http://your-server:8765/mcp
