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."

Поддерживаемые клиенты

Клиент	Статус	Настройка
Codex	Готов к локальному плагину	Настройка
Claude Code	Готов к локальному плагину	Настройка
Cursor	Каркас плагина	Настройка
Gemini CLI	Каркас расширения	Настройка
Gemini Antigravity	Готов к конфигурации MCP	Настройка
OpenCode	Готов к конфигурации MCP	Настройка
Generic MCP	Готов к конфигурации	Настройка

«Готов к локальному плагину» означает, что обертка интеграции включена и может быть протестирована локально. Отправка в маркетплейс и одобрение пока не включены.

Инструменты

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 только тогда, когда:

исправление/изменение было действительно предпринято
команда проверки действительно была выполнена
результат четко «пройден» (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

Moth