Moth

Mothは、プロジェクトローカルなバグ修正分析と検証済み修正メモリのための軽量なMCPサーバーです。

Mothの機能

MothはMCPを通じてエラー出力を受け取り、機密情報を秘匿化し、障害を正規化し、可能性の高いスタックを検出し、プロジェクトローカルな修正メモリを確認し、構造化された修正概要を返します。

Mothはコードの編集、シェルコマンドの実行、リポジトリのクロール、バックエンドの要求、グローバルなバグデータベースの維持は行いません。

なぜ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"]
    }
  }
}

使用例

MothをサポートされているAIエージェントで使用する場合、エラーと一緒に以下のような簡単なプロンプトを含めることができます。

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

サポートされているクライアント

「ローカルプラグイン対応」とは、統合ラッパーが含まれており、ローカルでテスト可能であることを意味します。マーケットプレイスへの提出と承認はまだ含まれていません。

ツール

Mothは正確に2つの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は、MCPサーバーの再起動後に remember_fix_result が analysis_id を正しいプロジェクトパスにマッピングできるように、プロジェクト外にMoth独自の小さな分析レジストリを保持します。

スキル

Mothには、互換性のあるエージェント向けの簡潔なスキルが含まれています:

• moth-debug-first-fix

• moth-source-backed-research

• moth-verify-fix

Mothサーバー自体はライブWebリサーチを実行しません。互換性のあるエージェントは、外部ソースが必要な場合、Mothのスキルに導かれて独自の検索ツールを使用する場合があります。

安全性

• デフォルトで読み取り専用

• ソースの編集なし

• シェル実行なし

• リポジトリ全体のスキャンなし

• バックグラウンド監視なし

• 外部サービスの要求なし

• 分析、応答、メモリ書き込みの前に機密情報を秘匿化

開発

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

ライセンス

MIT