VitaminMCP-minecraft logo

VitaminMCP-minecraft

Free

An MCP server that enables AI agents to perform real end-to-end testing of Minecraft servers using protocol-based bots and server introspection.

Visit Website
Related by shared tags and keywordsMeet Live AssistAmethystfinal-buzzer
ai-agentbukkitintegration-testingjavamcpaiai assistantautomation

Overview

VitaminMCP is a Paper/Purpur plugin that opens an MCP (Model Context Protocol) endpoint from inside a running Minecraft server. It lets an AI agent such as Claude Code, Cursor, Codex, Gemini CLI, or any MCP client drive the server and read back what happened, while real bot clients join over the actual Minecraft protocol. The plugin under test runs on a real server through its real lifecycle, with no test framework to adopt, no source to instrument, and no mock server. It also works on plugins the user did not write, because anything installed is testable.

The agent can spawn and control test players as real protocol clients, execute commands as the console or as a player, open, read, click, and assert on inventories and plugin GUIs, right-click NPCs and villagers, move players, break and use blocks, and chat. It can wait for events and conditions instead of sleeping, read the player's whole screen including menus, chat, action bar, titles, boss bars, and scoreboard, and read live server state such as events, logs, exceptions, and permissions. It can drive several servers at once, with one session per backend of a BungeeCord network.

MCP tools include session_start, session_reset, server_info, logs_query, events_summary, events_query, exceptions_recent, state_query, command_exec, wait_for, bot_spawn, bot_inspect, bot_run_scenario, and bot_view. Version support includes Minecraft 1.21–1.21.11 and 26.1–26.1.2 as supported and live-tested, while 1.18–1.20.6 is planned and 26.2 and later is released but needs a compatibility run. Setup involves installing the plugin, adding the MCP server to an AI client, and letting the agent wire itself up.

Pricing

Free

Detailed plans have not been confirmed in our catalog. Check the official website for current limits and billing terms.

Visit Website

Prices and limits may change. Confirm the currency, billing period, seat minimum and usage caps on the official website.

Use Cases

  • Teams use VitaminMCP to test plugins with an AI agent on a real running server with real players.
  • Teams use VitaminMCP to let an AI agent drive the server and read back what happened.
  • Teams use VitaminMCP to test plugins they did not write, since anything installed is testable.
  • Teams use VitaminMCP to spawn and control test players as real protocol clients.
  • Teams use VitaminMCP to execute commands as the console or as a player.
  • Teams use VitaminMCP to open, read, click and assert on inventories and plugin GUIs.
  • Teams use VitaminMCP to drive several servers at once for proxied networks.
  • Teams use VitaminMCP to run a whole scripted test in one call and see the failing step.

Features

Test Minecraft servers with AI agents

Run end-to-end server tests

Use protocol-based testing bots

Inspect Minecraft server behavior

Connect testing agents through MCP

Reviews

No reviews yet. Be the first to share your experience!