log-analyzer-mcp

Un servidor MCP (Model Context Protocol) que proporciona herramientas de análisis de registros y métricas del sistema. Se conecta a Claude Code a través del transporte stdio y expone 5 herramientas para buscar, contar y analizar archivos de registro locales.

Características

Inicio rápido

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run the server
npm start

Desarrollo

# Run with hot reload
npm run dev

Integración con Claude Code

Añade el servidor a Claude Code:

# Project-level (only available in this directory)
claude mcp add log-analyzer -- node /path/to/log-analyzer-mcp/dist/index.js

# User-level (available globally)
claude mcp add log-analyzer --scope user -- node /path/to/log-analyzer-mcp/dist/index.js

Verifica la conexión:

claude mcp list

Detalles de las herramientas

search_logs

Busca en archivos de registro por palabras clave o regex. Admite la búsqueda en un solo archivo .log o en un directorio completo.

{
  "keywords": ["ERROR", "timeout"],
  "regex": "connection.*failed",
  "logPath": "/var/log",
  "limit": 100
}

count_by_level

Cuenta entradas de registro por nivel de gravedad, opcionalmente filtradas por rango de tiempo.

{
  "logPath": "/var/log",
  "startTime": "2026-04-29T00:00:00Z",
  "endTime": "2026-04-30T00:00:00Z"
}

query_by_timerange

Filtra registros dentro de un rango de tiempo específico, con filtro de nivel opcional.

{
  "startTime": "2026-04-29T00:00:00Z",
  "endTime": "2026-04-30T00:00:00Z",
  "logPath": "/var/log",
  "level": "ERROR",
  "limit": 100
}

get_system_metrics

Obtiene métricas de CPU, memoria y disco. Compatible con Windows y Linux.

{
  "metrics": ["cpu", "memory", "disk"]
}

explain_error

Formatea el contenido del error para un análisis de causa raíz asistido por IA.

{
  "errorContent": "java.lang.NullPointerException\n  at com.example.Service.process(Service.java:42)",
  "contextLines": 10
}

Arquitectura

src/
├── index.ts           # MCP Server entry point
├── tools/             # Individual MCP tool implementations
├── utils/
│   ├── log_parser.ts  # Timestamp/level parsing, keyword/regex matching
│   └── metrics.ts     # Cross-platform CPU/memory/disk metrics
└── types/             # TypeScript type definitions

El servidor utiliza @modelcontextprotocol/sdk con StdioServerTransport. Las herramientas se registran a través del manejador CallToolRequestSchema.

Decisiones clave de diseño

• Procesamiento de flujo: Utiliza readline + createReadStream para manejar archivos de registro grandes sin cargarlos completamente en la memoria

• Multiplataforma: Implementación de doble ruta para Windows (WMIC) y Linux (top/free/df) con detección de plataforma en tiempo de ejecución

• Análisis tolerante: Los formatos de registro no estándar se conservan en lugar de descartarse (los niveles faltantes se establecen por defecto en INFO, las marcas de tiempo faltantes se establecen por defecto en la hora actual)

Licencia

MIT