SuperAPI AI 工具集

minecraft-debug-mcp

智能体与模型

查看项目

更新于 10-16 01:17

技能介绍

用途:在本地运行 Minecraft 机器人,并通过其内置 MCP 调试接口安全、快速地交互与排障。

主要能力:提供只读诊断与受控变更两类工具。可用 get_state 查看队列/处理状态及可用工具与动作(默认跳过 REPL 内置项,传 { includeBuiltins: true } 可包含);get_logs 查看日志;get_last_prompt 查看最近一次 LLM 输入;get_llm_trace 获取结构化的逐次尝试轨迹(消息、内容、推理、用量、时长);execute_repl 在运行中的 brain 上做深度对象检查或一次性调用;inject_chat 模拟玩家聊天以验证行为回路;inject_event 用于特定事件形态测试。

使用方式:在 /path/to/project/root/services/minecraft 下运行 pnpm dev 并保持运行,等待日志出现 MCP REPL server running at http://localhost:3001,将 MCP 客户端连接到 http://localhost:3001/sse。先用只读调用验证就绪:读取资源 brain://state,或调用工具 get_state。之后用能回答任务的最小工具/动作继续。若连接失败,检查 pnpm dev 是否仍在运行、端口 3001 是否空闲。

适用场景:验证行为变更、工具接线、规划/执行回路的回归;提示词工程测试前可用 execute_repl("forget_conversation()") 清空对话记忆。

限制与注意:先只读,必要时再升级到变更类工具;execute_repl 片段应最小且可回滚;inject_chat 有副作用,可能触发真实游戏内回复/动作;get_last_prompt 可能返回超大载荷,仅在需要提示词级调试时调用;execute_repl 的 returnValue 为字符串化结果,应按显示输出理解而非类型化 JSON;get_last_prompt 与 get_llm_trace 为降低 token 成本会省略系统提示/系统角色消息。精确工具/资源名与参数模式见 references/mcp-surface.md。