mcp-server-logs-sieve

mcp-server-logs-sieve ist ein MCP-Server, mit dem KI-Assistenten Protokolle direkt von Ihrem Observability-Backend abfragen können.

Stellen Sie Debugging-Fragen in einfacher Sprache und lassen Sie Logs Sieve die genauen Protokolle und den Kontext für Sie abrufen.

Warum gibt es das?

Bei Vorfällen fließt viel Zeit in repetitive Schritte:

• Finden der richtigen Protokollquelle

• Eingrenzen des Zeitfensters

• Erkennen wiederkehrender Fehlermuster

• Verfolgen einer Spur (Trace) über Dienste hinweg

Logs Sieve bündelt diese Arbeitsabläufe in vier Tools: query_logs, summarize_logs, trace_request und list_log_sources.

Related MCP server: Azure Logs MCP

Unterstützte Anbieter

• Google Cloud Logging (gcp)

• AWS CloudWatch Logs (aws)

• Azure Monitor Logs (azure)

• Grafana Loki (loki)

• Elasticsearch (elasticsearch)

Voraussetzungen

⚠️ Node.js 20 oder höher ist erforderlich.

Dieses Paket verwendet ES-Module und Abhängigkeiten, die Node.js 20+ benötigen. Wenn Sie ERR_MODULE_NOT_FOUND-Fehler sehen, überprüfen Sie Ihre Node-Version mit node -v und führen Sie bei Bedarf ein Upgrade durch.

Dies gilt unabhängig davon, ob Sie es über npx ausführen, global installieren oder aus dem Quellcode verwenden.

Schnelle MCP-Konfiguration

Beispiel .mcp.json:

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

Wenn Sie das Programm direkt aus diesem Repository-Quellcode ausführen, können Sie weiterhin node ./bin/mcp-server-logs-sieve.js --provider gcp verwenden.

Ersteinrichtung: Bei der ersten Verwendung muss npx das Paket herunterladen und installieren (~40s). Claude Code könnte beim Warten darauf eine Zeitüberschreitung (Timeout) erleiden. Führen Sie das Folgende einmal in Ihrem Terminal aus, um den Cache vorzubereiten, bevor Sie es zu Ihrer MCP-Konfiguration hinzufügen:

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

Danach startet Claude Code den Server sofort aus dem npx-Cache.

Starten Sie nach dem Aktualisieren der Konfiguration Ihren MCP-Client neu und bestätigen Sie mit /mcp.

Anbieter-Authentifizierung und Umgebungsvariablen

Siehe die anbieterspezifischen Einrichtungs- und Authentifizierungsdokumente:

• GCP

• AWS

• Azure

• Loki

• Elasticsearch

Für Elasticsearch API-Kompatibilitäts-Header:

export ELASTICSEARCH_COMPAT_VERSION=8

CLI-Nutzung

Das Paket enthält auch eine CLI für die direkte Terminalnutzung:

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

Dokumentation

• Dokumentations-Startseite

• Erste Schritte

• MCP-Client-Einrichtung (Claude Code, Claude Desktop, Cursor, Windsurf)

• Tool-Referenz

• Fehlerbehebung

• Kompatibilitätsmatrix

Mitwirken

Beiträge sind willkommen.

• Starten Sie hier: CONTRIBUTING.md

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

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