Moth

Moth es un servidor MCP ligero para el análisis de corrección de errores local al proyecto y la memoria de correcciones verificadas.

Qué hace Moth

Moth recibe la salida de errores a través de MCP, redacta posibles secretos, normaliza el fallo, detecta la pila probable, comprueba la memoria de correcciones local del proyecto y devuelve un resumen de corrección estructurado.

Moth no edita código, no ejecuta comandos de shell, no rastrea repositorios, no requiere un backend ni mantiene una base de datos global de errores.

¿Por qué Moth?

El contexto de corrección de errores suele ser local a un proyecto: el comando que falló, el framework en uso, la configuración cercana y las correcciones que ya han funcionado o fallado en ese repositorio.

Moth mantiene ese flujo de trabajo pequeño y explícito. Analiza el contexto de error proporcionado, sugiere una mejor primera corrección y registra solo los resultados de corrección verificados en la memoria local del proyecto.

Inicio rápido

Requiere Node.js 18+.

Ejecutar directamente:

npx -y @stfade/moth moth-mcp

O instalar globalmente:

npm install -g @stfade/moth
moth-mcp

Configuración genérica de MCP

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

Ejemplo de uso

Al usar Moth con un agente de IA compatible, puedes incluir un prompt simple como este junto con tu error:

"Usa Moth para analizar este error antes de corregirlo."

Clientes compatibles

“Listo para plugin local” significa que el envoltorio de integración está incluido y puede probarse localmente. La presentación y aprobación en el Marketplace aún no están incluidas.

Herramientas

Moth expone exactamente dos herramientas MCP.

analyze_error

Analiza la salida de error proporcionada antes de intentar una corrección.

Campos de entrada:

• error_output

• command?

• cwd?

• package_context?

• relevant_files?

• environment?

Campos de salida:

• analysis_id

• fingerprint

• stack

• likely_cause

• best_first_fix

• verification

• prior_project_fixes

• avoid

• confidence

remember_fix_result

Registra la memoria de corrección verificada local al proyecto.

Campos de entrada:

• analysis_id

• fingerprint

• stack

• fix_attempted

• verification_command

• verification_result: "passed" | "failed"

• notes?

La entrada pública worked es rechazada. worked se deriva de verification_result.

Ciclo de vida de la memoria verificada

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

Llama a remember_fix_result solo cuando:

1. se intentó realmente una corrección/cambio

2. el comando de verificación se ejecutó realmente

3. el resultado es claramente passed o failed

No lo llames para sugerencias, cambios omitidos, falta de verificación, resultados ambiguos o suposiciones.

Memoria local

La memoria de corrección verificada local al proyecto se almacena en:

.moth/fix-memory.jsonl

Moth mantiene un pequeño registro de análisis propiedad de Moth fuera del proyecto para que remember_fix_result pueda asignar analysis_id de nuevo a la ruta correcta del proyecto después de un reinicio del servidor MCP.

Habilidades

Moth incluye habilidades concisas para agentes compatibles:

• moth-debug-first-fix

• moth-source-backed-research

• moth-verify-fix

El servidor MCP en sí no realiza investigación web en vivo. Los agentes compatibles pueden usar sus propias herramientas de búsqueda, guiados por las habilidades de Moth, cuando se necesiten fuentes externas.

Seguridad

• solo lectura por defecto

• sin ediciones de código fuente

• sin ejecución de shell

• sin escaneo de todo el repositorio

• sin observador en segundo plano

• no requiere servicio externo

• redacta posibles secretos antes del análisis, las respuestas y las escrituras en memoria

Desarrollo

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

Licencia

MIT