VitaminMCP-minecraft

概览

VitaminMCP 是一个 Paper/Purpur 插件，在运行中的 Minecraft 服务器内部开放一个 MCP（模型上下文协议）端点。它让 Claude Code、Cursor、Codex、Gemini CLI 等 AI 智能体或任何 MCP 客户端可以驱动服务器并读回所发生的事情，同时真实的机器人客户端通过实际的 Minecraft 协议加入。被测试的插件在真实服务器上走完其真实的生命周期，无需采用测试框架、无需对源码插桩、也无需模拟服务器。它也适用于用户并非自己编写的插件，因为任何已安装的东西都可以测试。 智能体可以把测试玩家作为真实的协议客户端来生成和控制，以控制台或玩家身份执行命令，打开、读取、点击并断言物品栏和插件 GUI，右键点击 NPC 和村民，移动玩家，破坏和使用方块，以及聊天。它可以等待事件和条件而不是休眠，读取玩家的整个屏幕，包括菜单、聊天、动作栏、标题、Boss 血条和计分板，并读取事件、日志、异常和权限等实时服务器状态。它可以同时驱动多台服务器，对 BungeeCord 网络的每个后端各开一个会话。 MCP 工具包括 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 和 bot_view。版本支持方面，Minecraft 1.21–1.21.11 和 26.1–26.1.2 为受支持并已实际测试，1.18–1.20.6 在计划中，26.2 及更高版本已发布但需要进行兼容性运行。设置过程包括安装插件、把 MCP 服务器添加到 AI 客户端，然后让智能体自行完成接入。