VitaminMCP
Test your plugins with an AI agent — on a real running server, with real players.

Documentation · · ·
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y [email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add io.github.backas03-vitaminmcp -- npx -y vitaminmcp@3.2.2รันในเทอร์มินัล
{ "mcpServers": { "io.github.backas03-vitaminmcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Test your plugins with an AI agent — on a real running server, with real players.

Documentation · · ·
Test Minecraft plugins end to end: drive a real Paper server and real protocol bots.
VitaminMCP is a Paper/Purpur plugin that opens an MCP (Model Context Protocol) endpoint from inside your running server. Connect an AI agent — Claude Code, Cursor, Codex, Gemini CLI, any MCP client — and it can drive the server and read back what happened, while real bot clients join over the actual Minecraft protocol.
Nothing about the plugin you are testing changes. No test framework to adopt, no source to instrument, no mock server: the plugin under test runs on a real server through its real lifecycle. That also means it works on plugins you did not write — anything installed is testable.
Player objectsbot_run_scenario scripts a whole test from these steps — a failure reports the failing step and
what the server was doing at that moment:
How the three pieces fit together, what every tool and step accepts, and an example scenario are in docs/reference.md.
Legend: 🟢 supported · 🟡 planned or requires the stated runtime · 🔴 unsupported.
Requirements, where each claim comes from, and how the version matrix is run are in docs/reference.md.
1. Install the plugin — download VitaminMCP.jar from the
latest release (or from
Modrinth), drop it into plugins/, and start the server.
2. Add the MCP server to your AI client — it runs on your machine, not on the server:
Claude Code
claude mcp add vitaminmcp -- npx -y vitaminmcp
Claude Desktop, Cursor, or any client with a JSON MCP config:
{
"mcpServers": {
"vitaminmcp": {
"command": "npx",
"args": ["-y", "vitaminmcp"]
}
}
}
It is also on the official MCP registry as
io.github.Backas03/vitaminmcp, so clients with a registry catalogue can add it from there.
Clients that keep one stdio process per loaded project can instead connect all projects to
one shared loopback server. On Windows,
npx -y vitaminmcp service install installs and verifies that shared server in one command.
3. Let the agent wire itself up — ask it to run the setup prompt (in Claude Code:
/mcp__vitaminmcp__setup). It finds the running server, checks the plugin, and connects.
That is enough for a server on this machine. The Claude Code plugin (which also brings the testing
skill), other clients, installing from the jars, config.yml defaults, bot setup, and reaching a
server behind SSH or TLS are all in INSTALL.md.
Full installation and usage docs: backas03.github.io/VitaminMCP — every tool, scenario runs, multi-server sessions, and remote-server setup are covered in docs/usage.md.
Contribution rules are in CONTRIBUTING.md, building from source in docs/reference.md, and release steps in docs/publishing.md.
MIT — see LICENSE. The third-party code bundled in the jars, and its licenses, are listed in docs/reference.md.
Test Minecraft plugins end to end: drive a real Paper server and real protocol bots.
{ "mcpServers": { "io.github.backas03-vitaminmcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
VitaminMCP ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-08 Test Minecraft plugins end to end: drive a real Paper server and real protocol bots.