Skip to main content
Glama
At-grafana

At-grafana

by xwamt

AT Grafana

中文

AT Grafana ist eine VS Code / Cursor-Erweiterung der AT-Serie (zusammen mit at-terminal-series und at-jumpserver-series). Sie bringt Grafana-Dashboards und Unified Alerting in die IDE und stellt Agenten schreibgeschützte Grafana-Metadaten sowie Datasource-Abfragen (Prometheus, Loki, …) über das gemeinsame @at-series/mcp-hub-Protokoll v1 bereit.

Aktuelle Version: 0.1.3 — MCP-Katalog mit 17 schreibgeschützten Tools (typisiertes Prom/Loki, Discovery, Annotationen, Deeplink). Automatisierte Suite: Typprüfung + 559 Tests. Siehe docs/releases/0.1.3.md. Live-Grafana-/echte MCP-Client-Smoke-Checks sind weiterhin in docs/releases/0.1.0.md aufgeführt.

Funktionen

  • Multi-Instanz-Konfiguration — Bezeichnung, URL, Grafana Service Account Token (9.1+); Tokens liegen in VS Code SecretStorage, niemals im Klartext in den Einstellungen

  • TLS Trust-On-First-Use — die erste Verbindung fragt nach Bestätigung des Zertifikat-Fingerprints; Fingerprint-Änderungen schlagen fehl (Fail-Closed)

  • Dashboards-Seitenleiste — Grafana-Ordnerbaum, Titelfilter, Aktualisierung; Dashboard in eingebetteter Webview öffnen

  • Alerts-Seitenleiste — Unified-Alerting-Regeln mit Live-Status, Gruppierung nach Ordnern, Firing-Regeln zuerst sortiert

  • Native eingebettete Seiten — vollständig interaktive Grafana-Dashboard-/Alert-Detail-UI über einen lokalen 127.0.0.1-Reverse-Proxy, der Authorization auf Erweiterungsseite injiziert (Token ist für die Webview nie sichtbar)

  • Pro-Instanz-Agenten-Gate — „Allow background Agent access“ (Standard: aus); nur aktivierte Instanzen erscheinen in den MCP-Tools

  • 17 MCP-Tools (risk: read, nach AT-Series-MCP-Installation automatisch genehmigt):

    • Discovery: grafana_list_instances

    • Verwaltung: grafana_list_dashboards (optional query / tag / folderUid), grafana_get_dashboard (Standard: fields: "targets"; vollständiges Modell erfordert fields: "full"), grafana_list_folders, grafana_list_alert_rules (optional states), grafana_get_alert_rule, grafana_get_alert_history, grafana_list_annotations, grafana_generate_deeplink (openInIde Standard: false)

    • Monitoring: grafana_list_datasources, grafana_query_prometheus, grafana_query_loki, grafana_list_prometheus_metric_names, grafana_list_prometheus_label_values, grafana_list_loki_label_names, grafana_list_loki_label_values sowie grafana_query_datasource als Notausstieg. Die typisierten Prom/Loki-Tools sind zu bevorzugen; der generische Proxy unterstützt nur GET/POST, wobei path auf /api/datasources/proxy/uid/<uid>/ beschränkt ist, sodass Grafanas eigene APIs nicht erreichbar sind; Ergebnisse über dem Limit enthalten truncated: true

  • Gemeinsamer AT-Series-Hub — ein einziger AT Series-MCP-Eintrag für Cursor / Kiro / Continue; kein plugin-spezifischer MCP-Server

Related MCP server: Grafana MCP Server

Nicht in dieser Version

  • Einzelpanel-Drill-down (nur vollständige Dashboards)

  • Legacy Alerting (nur Unified Alerting)

  • Jegliche Schreib-/Mute-/Pause-Operationen gegen Grafana oder Datasources

  • Multi-Organisations-Unterstützung

  • Grafana Live / WebSocket-Push über den Embed-Proxy

Installation

  1. Eine VSIX erstellen (oder ein Release-Artefakt verwenden, sobald veröffentlicht):

npm install
npm run package   # produces at-grafana-0.1.3.vsix
  1. In VS Code / Cursor: Erweiterungen → ⋯ → Aus VSIX installieren… und die Datei auswählen.

  2. Die AT Grafana-Ansichten in der Aktivitätsleiste öffnen und dann AT Grafana: Add Instance ausführen.

Schnellstart

  1. Ein Grafana-Servicekonto mit Viewer erstellen und einen Token kopieren.

  2. AT Grafana: Add Instance → Bezeichnung, Basis-URL, Token → Test connection → TLS-Fingerprint bestätigen → speichern.

  3. Dashboards / Alerts durchsuchen; auf einen Knoten klicken, um die native Seite in einer Webview zu öffnen.

  4. (Optional, für Agenten) Die Instanz bearbeiten und Allow background Agent access aktivieren.

  5. (Optional) AT Grafana: Install/Repair AT Series MCP Config ausführen und dann den MCP-Client neu verbinden.

Vollständige Anleitung: docs/usage.md · 中文

Agenten-Skill

Skill

Zweck

at-grafana-mcp

Dashboards / Alert-Regeln prüfen und Prometheus/Loki-artige Daten über AT Grafana MCP abfragen

Mit der Skills-CLI installieren:

npx skills add xwamt/At-grafana --skill at-grafana-mcp

Entwicklung

npm install
npm run typecheck
npm test
npm run build      # bundles dist/extension.js (+ webview + hub copy via package scripts)
npm run package    # produces at-grafana-<version>.vsix

F5 bei geöffnetem Ordner drücken, um einen Extension Development Host zu starten.

Erfordert Node.js 20+ und einen VS Code / Cursor-Host, der engines.vscode (^1.85.0) entspricht.

Dokumentation

Dokument

Beschreibung

docs/features.md (中文)

Funktionsübersicht

docs/usage.md (中文)

Einrichtung, Agentenzugriff, MCP-Client

docs/releases/0.1.3.md

Aktuelle Versionshinweise (17-Tool-MCP-Katalog)

docs/releases/0.1.0.md

V1-Definition-of-Done-/Abnahmeprotokoll

docs/requirements.md

Vollständige Anforderungen (中文)

skills/at-grafana-mcp/SKILL.md

Agentenorientierter MCP-Katalog-Leitfaden

docs/decisions/

ADR-001 … ADR-007

docs/plans/2026-07-29-at-grafana-v1-implementation-plan.md

Phasenweise Implementierungshistorie

Aus at-terminal-series abgeleitet (unabhängige Git-Historie; SSH/SFTP/Terminal-Domäne entfernt) — siehe ADR-001.

Lizenz

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables AI-powered integration with Grafana instances through 52 MCP tools for dashboard management, Prometheus/Loki queries, alerting, and administrative functions. Supports complete Grafana functionality including metrics exploration, log analysis, and incident response through natural language.
      80
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to interact with Grafana dashboards, datasources, alerts, incidents, and monitoring data through 43 comprehensive tools. Supports querying Prometheus metrics, Loki logs, managing incidents, and dashboard operations with full authentication support.
      43
      690 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables MCP-compatible agents to interact with Grafana instances for searching, creating, and updating dashboards, exploring logs via Loki, querying datasources, managing alerts, incidents, and on-call shifts, and accessing observability data.
      8
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query Grafana dashboards, alerts, and datasources for observability insights and incident investigation.
      MIT