Moth

Moth 是一个轻量级的 MCP 服务器，用于项目本地的错误修复分析和已验证修复记录存储。

Moth 的功能

Moth 通过 MCP 接收错误输出，屏蔽潜在的敏感信息，标准化故障，检测可能的堆栈，检查项目本地的修复记录，并返回结构化的修复摘要。

Moth 不会编辑代码、运行 shell 命令、抓取仓库、要求后端支持或维护全局错误数据库。

为什么选择 Moth？

错误修复的上下文通常是项目本地的：失败的命令、使用的框架、附近的配置，以及在该仓库中已经成功或失败的修复方案。

Moth 使该工作流保持精简且明确。它分析提供的错误上下文，建议最佳的首选修复方案，并仅在项目本地内存中记录已验证的修复结果。

快速开始

需要 Node.js 18+。

直接运行：

npx -y @stfade/moth moth-mcp

或全局安装：

npm install -g @stfade/moth
moth-mcp

通用 MCP 配置

{
  "mcpServers": {
    "moth": {
      "command": "npx",
      "args": ["-y", "@stfade/moth", "moth-mcp"]
    }
  }
}

使用示例

当在支持的 AI 代理中使用 Moth 时，您可以包含如下简单的提示词以及您的错误信息：

"Use Moth to analyze this error before fixing it."

支持的客户端

“本地插件就绪”意味着集成的包装器已包含在内，可以在本地进行测试。市场提交和审核尚未包含在内。

工具

Moth 仅公开两个 MCP 工具。

analyze_error

在尝试修复之前分析提供的错误输出。

输入字段：

• error_output

• command?

• cwd?

• package_context?

• relevant_files?

• environment?

输出字段：

• analysis_id

• fingerprint

• stack

• likely_cause

• best_first_fix

• verification

• prior_project_fixes

• avoid

• confidence

remember_fix_result

记录已验证的项目本地修复记录。

输入字段：

• analysis_id

• fingerprint

• stack

• fix_attempted

• verification_command

• verification_result: "passed" | "failed"

• notes?

公共的 worked 输入将被拒绝。worked 是从 verification_result 派生出来的。

已验证记录生命周期

analyze_error
→ apply/attempt fix
→ run verification command
→ remember_fix_result

仅在以下情况调用 remember_fix_result：

1. 确实尝试了修复/更改

2. 验证命令确实运行了

3. 结果明确为 passed 或 failed

不要将其用于建议、跳过的更改、缺失验证、模棱两可的结果或猜测。

本地存储

已验证的项目本地修复记录存储在：

.moth/fix-memory.jsonl

Moth 在项目外部保留了一个小型 Moth 拥有的分析注册表，以便 remember_fix_result 可以在 MCP 服务器重启后将 analysis_id 映射回正确的项目路径。

技能

Moth 为兼容的代理提供了简洁的技能：

• moth-debug-first-fix

• moth-source-backed-research

• moth-verify-fix

Moth 服务器本身不执行实时网络研究。当需要外部资源时，兼容的代理可以在 Moth 技能的指导下使用它们自己的搜索工具。

安全性

• 默认只读

• 无源代码编辑

• 无 shell 执行

• 无全仓库扫描

• 无后台监视器

• 无需外部服务

• 在分析、响应和内存写入之前屏蔽潜在的敏感信息

开发

pnpm install
pnpm test
pnpm build
pnpm dev
npm pack --dry-run

许可证

MIT