原创 [MC-Plugin-Tester]自动化测试我的世界插件的MCP 1.0

[MD] ### MCP-MC-Plugin-Tester **项目简介** 本工具是一个基于 Node.js 开发的 MCP Server，旨在为 AI 编程助手（如 Claude, Cursor, Windsurf 等）提供与 Minecraft 服务器交互的能力 它封装了 Mineflayer 的核心功能，将物理层面的游戏操作转化为逻辑层面的测试接口，使 AI 能够直接参与到插件开发的生命周期中，进行自动化验收测试 **核心功能** * **连接管理**：支持连接至指定 Minecraft 服务器，自动处理登录与状态维持 * **指令交互**： * `send_chat`：发送聊天消息或指令 * `fetch_chat`：基于队列的消息获取机制，支持批量获取服务器返回信息，用于验证指令执行结果 * **GUI 交互**： * `get_gui_content`：解析当前打开的 GUI 界面，返回物品列表、名称、数量及 Lore 描述（支持 NBT 解析）。 * `click_gui_slot`：模拟玩家点击 GUI 槽位，支持测试菜单跳转与功能触发 * `close_gui`：关闭当前 GUI 界面 **技术架构** * **协议层**：基于 `@modelcontextprotocol/sdk` 实现标准 MCP 通信 * **控制层**：基于 `mineflayer` 与 `mineflayer-gui` 实现机器人控制 * **运行环境**：Node.js 18+ **配置与使用** 1. 环境要求：Node.js 18 或更高版本 2. 安装依赖：`npm install` 3. 编译项目：`npm run build` 4. MCP 客户端配置示例（以 Claude Desktop 为例）： ```json { "mcpServers": { "minecraft-plugin-tester": { "command": "node", "args": ["dist/index.js"], "cwd": "你的项目路径" } } } ``` **适用场景** * 插件开发者希望利用 AI 辅助开发并自动进行回归测试 * 自动化验证插件的指令反馈逻辑 * 自动化测试基于 GUI 的菜单交互流程 [/MD]

使用时图片

连接MCP


连接我的世界服务器并获取到物品栏中的物品