📖About CommandNeural

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