MCP

Grafana MCP: Zuerst Datenquellen auflisten, nicht gleich ein ganzes großes Dashboard holen

Für alle mit Grafana 9.0+ und Service-Account-Token, die Datenquellen oder Dashboards ansehen wollen; beim ersten Mal nur lesend Datenquellen — runpanelquery nicht aktivieren.

Official source · grafana/mcp-grafana

Install

uvx mcp-grafana

Für wen

Für alle, die bereits eine Grafana-9.0-Instanz oder neuer haben und ein Modell Instanz und Umfeld (Dashboards, Datenquellen) ansehen lassen wollen. Die Evidenz sagt: Dieses MCP bietet Zugriff auf eine Grafana-Instanz und das umgebende Ökosystem.

Du musst GRAFANA_URL und ein Service-Account-Token GRAFANA_SERVICE_ACCOUNT_TOKEN liefern können. Unter 9.0 können manche Funktionen (vor allem datenquellenbezogen) wegen fehlender APIs ausfallen.

Die Evidenz listet keine Clients und schreibt die meisten Tool-Funktionsnamen nicht. Beim ersten Mal nur schreibgeschützt ansehen: panel query (standardmäßig aus) nicht einschalten, und das Beispiel localhost:3000 nicht 1:1 in Produktion verwenden.

Erster Versuch in 3 Minuten

Nimm den uvx-Hauptpfad. Im Client konfigurieren:

"command": "uvx",
"args": ["mcp-grafana"],
"env": {
  "GRAFANA_URL": "http://localhost:3000",
  "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your service account token>"
}

URL durch deine Instanz ersetzen, Token durch ein Service-Account-Token. Nicht ins Gespräch schreiben.

Voraussetzungen: Grafana ≥ 9.0 erreichbar; das Service-Konto darf Datenquellen listen oder Dashboards lesen. Dieser Aufruf geht mit Token an dein Grafana, kein Offline-Sandbox.

Konfiguration: command / args / env des Client-MCP.

Risikoarmer erster Aufruf: zuerst „Datenquelleninformationen auflisten und holen“ (Evidenz-Fähigkeit). Nicht zuerst ein ganzes großes Dashboard per UID ziehen. Run-panel-query-Tools sind standardmäßig aus; runpanelquery nicht nur für den ersten Versuch in --enabled-tools aufnehmen.

Erfolgssignal: Nach der Verbindung siehst du die konfigurierte Datenquellenliste. Bei 401 oder keiner Verbindung zuerst URL und Token prüfen und ob die Instanz ≥ 9.0 ist.

Anwendungsfälle

Fall 1: Sehen, welche Datenquellen die Instanz hat. „List and fetch datasource information“ nutzen. Die Evidenz nennt unterstützte Typen inkl. Prometheus, Loki, ClickHouse, CloudWatch, Elasticsearch, OpenSearch, Snowflake, Athena. Keine Tool-Funktionsnamen, keine Filterparameter. Bestätigt ist: konfigurierte Datenquellen und ihre Details.

Fall 2: Volle Details eines Dashboards per UID holen. Die Evidenz warnt: große Dashboards fressen viel Kontextfenster. Nimm ein Dashboard, dessen UID du kennst und das nicht riesig ist; ist die Rückgabe zu lang, bei „Evidenz hat Kontextverbrauch gewarnt“ stoppen — nicht wiederholt voll holen. Die Evidenz gibt keinen locator-Text für ein JSONPath-Kürzungstool; keinen Ersatz-Toolnamen erfinden.

Grenzen

Braucht Grafana 9.0+, GRAFANA_URL und Service-Account-Token. runpanelquery ist standardmäßig deaktiviert und führt panel query erst nach dem Einschalten aus. Ein ganzes Dashboard per UID kann den Kontext sprengen. Datenquellentypen nur die genannten. Kein undo, keine vollständige Toolnamensliste, keine Least-Privilege-Aussage zum Token. Zugriff auf Grafana und Datenquellen ist kein Nullrisiko: was das Service-Konto sieht, sieht das Modell. „Schreibgeschützt Datenquellen listen“ heißt nicht „kein Netz“ und nicht „keine sensiblen Metriknamen“.