At-grafana
AT Grafana
AT Grafana は AT シリーズ(at-terminal-series および at-jumpserver-series と並ぶ)の VS Code / Cursor 拡張機能です。Grafana のダッシュボードと Unified Alerting を IDE にもたらし、読み取り専用の Grafana メタデータとデータソースクエリ(Prometheus、Loki など)を、共有の @at-series/mcp-hub Protocol v1 を通じてエージェントに公開します。
現在のバージョン: 0.1.3 — MCP カタログは 17 個の読み取り専用ツール(型付き Prom/Loki、ディスカバリ、アノテーション、ディープリンク)に整合。自動テストスイート: 型チェック + 559 テスト。docs/releases/0.1.3.md を参照。実 Grafana / 実 MCP クライアントのスモークチェックは docs/releases/0.1.0.md に引き続き記載されています。
機能
マルチインスタンス設定 — ラベル、URL、Grafana Service Account Token(9.1+)。トークンは VS Code の
SecretStorageに保存され、平文の設定には一切保存されませんTLS Trust-On-First-Use — 初回接続時に証明書フィンガープリントの確認を求めます。フィンガープリントの変更時はフェイルクローズします
ダッシュボードサイドバー — Grafana フォルダツリー、タイトルフィルタ、更新。ダッシュボードは組み込み Webview で開きます
アラートサイドバー — ライブ状態付きの Unified Alerting ルール、フォルダごとのグループ化、Firing ルールを先頭にソート
ネイティブ埋め込みページ — ローカル
127.0.0.1リバースプロキシを介した完全対話型の Grafana ダッシュボード / アラート詳細 UI。Authorizationは拡張機能側で注入されます(トークンが Webview に表示されることはありません)インスタンスごとのエージェントゲート — 「バックグラウンドエージェントアクセスを許可」(デフォルトはオフ)。有効化されたインスタンスのみが MCP ツールに表示されます
17 個の MCP ツール(
risk: read、AT シリーズ MCP インストール後に自動承認):ディスカバリ:
grafana_list_instances管理:
grafana_list_dashboards(オプションのquery/tag/folderUid)、grafana_get_dashboard(デフォルトはfields: "targets"。完全なモデルにはfields: "full"が必要)、grafana_list_folders、grafana_list_alert_rules(オプションのstates)、grafana_get_alert_rule、grafana_get_alert_history、grafana_list_annotations、grafana_generate_deeplink(openInIdeはデフォルト false)モニタリング:
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、およびエスケープハッチとしてのgrafana_query_datasource。型付き Prom/Loki ツールを優先してください。汎用プロキシはGET/POSTのみで、pathは/api/datasources/proxy/uid/<uid>/に制限されているため、Grafana 自身の API には到達できません。容量超過の結果にはtruncated: trueが含まれます
共有 AT シリーズハブ — Cursor / Kiro / Continue 用の単一の
AT SeriesMCP エントリ。プラグイン固有の MCP サーバーは不要です
Related MCP server: Grafana MCP Server
このリリースに含まれないもの
単一パネルのドリルダウン(フルダッシュボードのみ)
レガシー Alerting(Unified Alerting のみ)
Grafana またはデータソースに対する書き込み / ミュート / 一時停止
マルチオーガニゼーション対応
埋め込みプロキシを介した Grafana Live / WebSocket プッシュ
インストール
VSIX をビルドします(公開後はリリースアセットも利用可能):
npm install
npm run package # produces at-grafana-0.1.3.vsixVS Code / Cursor で: 拡張機能 → ⋯ → VSIX からインストール… を選択し、ファイルを選択します。
AT Grafana アクティビティバービューを開き、AT Grafana: Add Instance を実行します。
クイックスタート
Viewer 権限の Grafana Service Account を作成し、トークンをコピーします。
AT Grafana: Add Instance → ラベル、ベース URL、トークン → 接続テスト → TLS フィンガープリントを確認 → 保存。
ダッシュボード / アラート を閲覧し、ノードをクリックして Webview でネイティブページを開きます。
(オプション、エージェント用)インスタンスを編集し、バックグラウンドエージェントアクセスを許可 を有効にします。
(オプション)AT Grafana: Install/Repair AT Series MCP Config を実行し、MCP クライアントを再接続します。
完全なウォークスルー: docs/usage.md · 中文
エージェントスキル
スキル | 目的 |
AT Grafana MCP を通じてダッシュボード / アラートルールを調査し、Prometheus/Loki 形式のデータをクエリする |
スキル CLI でインストール:
npx skills add xwamt/At-grafana --skill at-grafana-mcp開発
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 を押すと、拡張機能開発ホストが起動します。
Node.js 20+ と、engines.vscode(^1.85.0)に一致する VS Code / Cursor ホストが必要です。
ドキュメント
ドキュメント | 説明 |
機能概要 | |
セットアップ、エージェントアクセス、MCP クライアント | |
現在のリリースノート(17 ツール MCP カタログ) | |
V1 の Definition-of-Done / 受入記録 | |
完全な要件(中文) | |
エージェント向け MCP カタログガイド | |
ADR-001 … ADR-007 | |
段階的実装の履歴 |
at-terminal-series からスキャフォールド(独立した git 履歴。SSH/SFTP/ターミナルドメインは削除済み)— ADR-001 を参照。
ライセンス
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