At-grafana
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 EinstellungenTLS 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, derAuthorizationauf 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_instancesVerwaltung:
grafana_list_dashboards(optionalquery/tag/folderUid),grafana_get_dashboard(Standard:fields: "targets"; vollständiges Modell erfordertfields: "full"),grafana_list_folders,grafana_list_alert_rules(optionalstates),grafana_get_alert_rule,grafana_get_alert_history,grafana_list_annotations,grafana_generate_deeplink(openInIdeStandard: 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_valuessowiegrafana_query_datasourceals Notausstieg. Die typisierten Prom/Loki-Tools sind zu bevorzugen; der generische Proxy unterstützt nurGET/POST, wobeipathauf/api/datasources/proxy/uid/<uid>/beschränkt ist, sodass Grafanas eigene APIs nicht erreichbar sind; Ergebnisse über dem Limit enthaltentruncated: 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
Eine VSIX erstellen (oder ein Release-Artefakt verwenden, sobald veröffentlicht):
npm install
npm run package # produces at-grafana-0.1.3.vsixIn VS Code / Cursor: Erweiterungen → ⋯ → Aus VSIX installieren… und die Datei auswählen.
Die AT Grafana-Ansichten in der Aktivitätsleiste öffnen und dann AT Grafana: Add Instance ausführen.
Schnellstart
Ein Grafana-Servicekonto mit Viewer erstellen und einen Token kopieren.
AT Grafana: Add Instance → Bezeichnung, Basis-URL, Token → Test connection → TLS-Fingerprint bestätigen → speichern.
Dashboards / Alerts durchsuchen; auf einen Knoten klicken, um die native Seite in einer Webview zu öffnen.
(Optional, für Agenten) Die Instanz bearbeiten und Allow background Agent access aktivieren.
(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 |
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-mcpEntwicklung
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>.vsixF5 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 |
Funktionsübersicht | |
Einrichtung, Agentenzugriff, MCP-Client | |
Aktuelle Versionshinweise (17-Tool-MCP-Katalog) | |
V1-Definition-of-Done-/Abnahmeprotokoll | |
Vollständige Anforderungen (中文) | |
Agentenorientierter MCP-Katalog-Leitfaden | |
ADR-001 … ADR-007 | |
Phasenweise Implementierungshistorie |
Aus at-terminal-series abgeleitet (unabhängige Git-Historie; SSH/SFTP/Terminal-Domäne entfernt) — siehe ADR-001.
Lizenz
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Query application logs, traces, and metrics from your AI coding assistant via Foam's MCP server.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
The Cortex MCP server provides read-only access to real-time engineering context from the Cortex developer portal, allowing AI coding assistants to answer natural language questions about your organization's catalog (microservices, libraries, domains, teams, infrastructure), scorecards (engineering standards and best practices), initiatives (goals and deadlines), and Engineering Intelligence metrics. It includes tools for querying documentation, tracking personal entities, and accessing AI-assisted insights across the entire Cortex ecosystem.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables 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.801MIT
- AlicenseBqualityDmaintenanceEnables 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.43690 npm3MIT
- AlicenseNot gradedqualityDmaintenanceEnables 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.8Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to query Grafana dashboards, alerts, and datasources for observability insights and incident investigation.MIT