Moth

Moth — это легковесный MCP-сервер для анализа исправлений ошибок локально в проекте и хранения проверенных решений.

Что делает Moth

Moth получает вывод ошибок через MCP, скрывает потенциальные секретные данные, нормализует сбой, определяет вероятный стек, проверяет локальную память исправлений проекта и возвращает структурированную сводку по исправлению.

Moth не редактирует код, не выполняет команды оболочки, не сканирует репозитории, не требует бэкенда и не ведет глобальную базу данных ошибок.

Related MCP server: looplens-mcp

Почему 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 предоставляет ровно два 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 хранит небольшой реестр анализа вне проекта, чтобы remember_fix_result мог сопоставить analysis_id с правильным путем к проекту после перезапуска MCP-сервера.

Навыки

Moth включает краткие навыки для совместимых агентов:

• moth-debug-first-fix

• moth-source-backed-research

• moth-verify-fix

Сам MCP-сервер не выполняет поиск в реальном времени в интернете. Совместимые агенты могут использовать свои собственные инструменты поиска, руководствуясь навыками Moth, когда требуются внешние источники.

Безопасность

• только чтение по умолчанию

• никаких правок исходного кода

• никакого выполнения команд оболочки

• никакого сканирования всего репозитория

• никакого фонового наблюдения

• не требуется внешний сервис

• скрывает потенциальные секретные данные перед анализом, ответами и записью в память

Разработка

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

Лицензия

MIT