用途：Moth 是一个轻量级 MCP 服务器，用于项目本地的缺陷修复分析与已验证修复记忆，把终端报错转化为有来源依据的修复建议，供 AI 编程智能体使用。
主要能力：通过 MCP 接收错误输出，先对疑似密钥进行脱敏，再规范化失败信息、识别可能的技术栈、检查项目本地修复记忆，最后返回结构化的修复简报。它只暴露两个 MCP 工具：analyze_error（在尝试修复前分析提供的错误输出，可带 package_context、relevant_files、prior_project_fixes 等上下文）和 remember_fix_result（记录已验证的项目本地修复记忆，需提供 verification_command 与 verification_result，取值为 passed 或 failed；worked 由 verification_result 推导，公开的 worked 输入会被拒绝）。已验证记忆存放在项目本地，另有一个 Moth 自有的小型分析注册表放在项目之外，用于在 MCP 服务器重启后把 analysis_id 映射回正确项目路径。还包含面向兼容智能体的技能：moth-debug-first-fix、moth-source-backed-research、moth-verify-fix。
使用方式：需要 Node.js 18+，可全局安装，并按通用 MCP 配置接入支持的 AI 智能体；使用时可在错误信息旁附上提示，例如“Use Moth to analyze this error before fixing it.”。仅在确实尝试了修复、验证命令确实运行、结果明确为通过或失败时才调用 remember_fix_result；建议、跳过改动、缺少验证、结果含糊或猜测都不应记录。
限制：Moth 不编辑代码、不执行 shell 命令、不爬取仓库、不需要后端、不维护全局缺陷数据库；默认只读，无源码修改、无仓库级扫描、无后台监听、无外部服务依赖。MCP 服务器本身不进行实时网络检索，兼容智能体可在 Moth 技能引导下使用自身搜索工具获取外部来源。支持客户端中“本地插件就绪”指集成包装已包含并可本地测试，尚未包含市场提交与审批。
