mcp-server-logs-sieve

mcp-server-logs-sieve es un servidor MCP que permite a los asistentes de IA consultar registros directamente desde tu backend de observabilidad.

Haz preguntas de depuración en lenguaje sencillo y deja que Logs Sieve obtenga los registros y el contexto exactos para ti.

Por qué existe esto

Durante los incidentes, se pierde mucho tiempo en pasos repetitivos:

• encontrar la fuente de registro correcta

• reducir la ventana de tiempo

• detectar patrones de fallo recurrentes

• seguir un rastro a través de los servicios

Logs Sieve empaqueta esos flujos de trabajo en cuatro herramientas: query_logs, summarize_logs, trace_request y list_log_sources.

Related MCP server: Azure Logs MCP

Proveedores compatibles

• Google Cloud Logging (gcp)

• AWS CloudWatch Logs (aws)

• Azure Monitor Logs (azure)

• Grafana Loki (loki)

• Elasticsearch (elasticsearch)

Requisitos previos

⚠️ Se requiere Node.js 20 o superior.

Este paquete utiliza módulos ES y dependencias que necesitan Node.js 20+. Si ves errores de ERR_MODULE_NOT_FOUND, verifica tu versión de Node con node -v y actualízala si es necesario.

Esto se aplica tanto si ejecutas a través de npx, instalas globalmente o utilizas desde el código fuente.

Configuración rápida de MCP

Ejemplo de .mcp.json:

{
  "mcpServers": {
    "logs-sieve": {
      "command": "npx",
      "args": ["-y", "mcp-server-logs-sieve@latest", "--provider", "gcp"]
    }
  }
}

Si ejecutas directamente desde el código fuente de este repositorio, aún puedes usar node ./bin/mcp-server-logs-sieve.js --provider gcp.

Configuración inicial: En el primer uso, npx necesita descargar e instalar el paquete (~40s). Claude Code puede agotar el tiempo de espera esperando esto. Ejecuta lo siguiente una vez en tu terminal para preparar la caché antes de añadirlo a tu configuración de MCP:

npx mcp-server-logs-sieve@latest --provider gcp
# (Ctrl+C once it starts — you just need the install to complete)

Después de eso, Claude Code iniciará el servidor instantáneamente desde la caché de npx.

Tras actualizar la configuración, reinicia tu cliente MCP y confirma con /mcp.

Autenticación del proveedor y variables de entorno

Consulta la configuración específica del proveedor y los documentos de autenticación:

• GCP

• AWS

• Azure

• Loki

• Elasticsearch

Para encabezados de compatibilidad de la API de Elasticsearch:

export ELASTICSEARCH_COMPAT_VERSION=8

Uso de la CLI

El paquete también incluye una CLI para uso directo en la terminal:

mcp-server-logs-sieve query --provider gcp --scope my-project --last 1h --filter "payment failed"
mcp-server-logs-sieve summarize --provider gcp --scope my-project --last 24h
mcp-server-logs-sieve trace --provider gcp --scope my-project --trace <trace-id>
mcp-server-logs-sieve sources --provider gcp --scope my-project

Documentación

• Inicio de la documentación

• Primeros pasos

• Configuración del cliente MCP (Claude Code, Claude Desktop, Cursor, Windsurf)

• Referencia de herramientas

• Solución de problemas

• Matriz de compatibilidad

Contribuciones

Las contribuciones son bienvenidas.

• Empieza aquí: CONTRIBUTING.md

• Problemas: https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/issues

• Discusiones: https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/discussions