What it does
VitaminMCP is a Paper and Purpur plugin that opens an MCP endpoint inside a running server. An MCP client such as Claude Code, Cursor, Codex or Gemini CLI can run commands as the console or as a player, open and click inventories and plugin GUIs, read live server state, logs and captured events, and spawn bot players that join over the real Minecraft protocol. Scenario tools run scripted tests, reporting the failing step and what the server was doing at that moment.
It suits testing plugins end to end on a real server, including plugins the developer did not write. No test framework, source instrumentation or mock server is required, and the tested plugin runs through its normal lifecycle. Scenarios can cover movement, block and item use, right-clicking NPCs, menu clicks, and assertions on positions, events, inventories and messages. Sessions can also drive several servers at once, one per backend of a BungeeCord network.
The plugin is installed on a Paper or Purpur server, and the agent connects to it through MCP. Version support is tiered: Minecraft 1.21 to 1.21.11 and 26.1 to 26.1.2 are supported and live-tested on Windows, Linux and macOS, while 26.2 to 26.3 supports the agent but not bots yet. Runners are available as a Node source runner or a native runner asset for Windows x64, Linux x64 and arm64, and macOS Intel and Apple Silicon.
Limitations and requirements
Bot players connect with an offline account or a Microsoft-authenticated Minecraft account. Bots cannot join Minecraft 26.2 to 26.3 yet, although the agent works there. Versions 1.18 to 1.20.6 are planned but fall below the current agent minimum of 1.21. Later releases need a compatibility run before support is added. The macOS native runner asset is ad-hoc signed.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
VitaminMCP
Test Minecraft plugins end to end: drive a real Paper server and real protocol bots.
v3.2.2As shown on registry.modelcontextprotocol.io when we last read it