Lokaler Loki MCP Server

Ein kleiner, schreibgeschützter MCP-Server für eine lokale Grafana-Loki-Instanz. Er ist mit FastAPI und dem offiziellen MCP Python SDK erstellt.

Was er bereitstellt

• search_logs(service, start, end, text=None) — durchsucht einen erforderlichen Dienst und optionalen wörtlichen Text innerhalb eines erforderlichen RFC 3339-Zeitbereichs.

• list_services(start, end) — listet die verfügbaren Service-Label-Werte auf.

• loki_health() — prüft, ob Loki bereit ist.

Das öffentliche Tool hat keinen limit-Parameter. Die Anfrage lässt auch Lokis limit-Abfrageparameter aus, sodass Lokis eigener konfigurierter Standard/Maximalwert gilt.

Related MCP server: grafana-mcp

Ausführen

1. Installieren Sie Python 3.11 oder neuer, erstellen Sie dann eine virtuelle Umgebung und aktivieren Sie sie.

   py -3.11 -m venv .venv
   .\.venv\Scripts\Activate.ps1
   pip install -r requirements.txt

2. Setzen Sie Umgebungsvariablen in Ihrer Shell, wenn die Standardwerte nicht zu Ihrer Einrichtung passen. .env.example listet die verfügbaren Einstellungen auf. Die Standardwerte erwarten Loki unter http://127.0.0.1:3100 und ein service_name-Label.

3. Starten Sie den Server.

   uvicorn main:app --reload

Der MCP-Streamable-HTTP-Endpunkt ist http://127.0.0.1:8000/mcp. Der eigene Health-Endpunkt des Servers ist http://127.0.0.1:8000/health.

Beispiel

Aufruf von search_logs mit:

{
  "service": "checkout",
  "text": "connection refused",
  "start": "2026-08-26T08:00:00Z",
  "end": "2026-08-26T09:00:00Z"
}

erzeugt diese LogQL-Abfrage:

{service_name="checkout"} |= "connection refused"

Wenn Ihre Labels stattdessen app verwenden, starten Sie den Server mit $env:LOKI_SERVICE_LABEL = "app".