Moth

Moth ist ein leichtgewichtiger MCP-Server für projektlokale Fehlerbehebungsanalysen und verifizierten Korrekturspeicher.

Was Moth tut

Moth empfängt Fehlerausgaben über MCP, schwärzt potenzielle Geheimnisse, normalisiert den Fehler, erkennt den wahrscheinlichen Stack, prüft den projektlokalen Korrekturspeicher und gibt eine strukturierte Zusammenfassung der Korrektur zurück.

Moth bearbeitet keinen Code, führt keine Shell-Befehle aus, durchsucht keine Repositories, benötigt kein Backend und verwaltet keine globale Fehlerdatenbank.

Warum Moth?

Der Kontext für Fehlerbehebungen ist oft projektspezifisch: der Befehl, der fehlgeschlagen ist, das verwendete Framework, die Konfiguration in der Nähe sowie Korrekturen, die in diesem Repository bereits funktioniert haben oder fehlgeschlagen sind.

Moth hält diesen Workflow klein und explizit. Es analysiert den bereitgestellten Fehlerkontext, schlägt eine optimale erste Korrektur vor und speichert nur verifizierte Korrekturergebnisse im projektlokalen Speicher.

Schnellstart

Erfordert Node.js 18+.

Direkt ausführen:

npx -y @stfade/moth moth-mcp

Oder global installieren:

npm install -g @stfade/moth
moth-mcp

Generische MCP-Konfiguration

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

Anwendungsbeispiel

Wenn Sie Moth mit einem unterstützten KI-Agenten verwenden, können Sie zusammen mit Ihrem Fehler eine einfache Aufforderung wie diese einfügen:

"Verwende Moth, um diesen Fehler zu analysieren, bevor du ihn behebst."

Unterstützte Clients

„Lokales Plugin bereit“ bedeutet, dass der Integrations-Wrapper enthalten ist und lokal getestet werden kann. Marktplatz-Einreichung und -Freigabe sind noch nicht enthalten.

Tools

Moth stellt genau zwei MCP-Tools bereit.

analyze_error

Analysiert die bereitgestellte Fehlerausgabe, bevor eine Korrektur versucht wird.

Eingabefelder:

• error_output

• command?

• cwd?

• package_context?

• relevant_files?

• environment?

Ausgabefelder:

• analysis_id

• fingerprint

• stack

• likely_cause

• best_first_fix

• verification

• prior_project_fixes

• avoid

• confidence

remember_fix_result

Speichert verifizierte projektlokale Korrekturergebnisse.

Eingabefelder:

• analysis_id

• fingerprint

• stack

• fix_attempted

• verification_command

• verification_result: "passed" | "failed"

• notes?

Die öffentliche Eingabe worked wird abgelehnt. worked wird aus verification_result abgeleitet.

Lebenszyklus des verifizierten Speichers

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

Rufen Sie remember_fix_result nur auf, wenn:

1. tatsächlich eine Korrektur/Änderung versucht wurde

2. der Verifizierungsbefehl tatsächlich ausgeführt wurde

3. das Ergebnis eindeutig passed oder failed ist

Rufen Sie es nicht für Vorschläge, übersprungene Änderungen, fehlende Verifizierung, mehrdeutige Ergebnisse oder Vermutungen auf.

Lokaler Speicher

Der verifizierte projektlokale Korrekturspeicher wird hier gespeichert:

.moth/fix-memory.jsonl

Moth unterhält ein kleines, Moth-eigenes Analyseregister außerhalb des Projekts, damit remember_fix_result nach einem Neustart des MCP-Servers die analysis_id wieder dem korrekten Projektpfad zuordnen kann.

Skills

Moth enthält prägnante Skills für kompatible Agenten:

• moth-debug-first-fix

• moth-source-backed-research

• moth-verify-fix

Der MCP-Server selbst führt keine Live-Webrecherche durch. Kompatible Agenten können ihre eigenen Suchwerkzeuge verwenden, geleitet durch Moth-Skills, wenn externe Quellen benötigt werden.

Sicherheit

• standardmäßig schreibgeschützt

• keine Quellcode-Änderungen

• keine Shell-Ausführung

• kein Scan des gesamten Repositorys

• kein Hintergrund-Watcher

• kein externer Dienst erforderlich

• schwärzt potenzielle Geheimnisse vor der Analyse, den Antworten und dem Schreiben in den Speicher

Entwicklung

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

Lizenz

MIT