Skip to main content
Glama
At-grafana

At-grafana

by xwamt

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 Series MCP エントリ。プラグイン固有の MCP サーバーは不要です

Related MCP server: Grafana MCP Server

このリリースに含まれないもの

  • 単一パネルのドリルダウン(フルダッシュボードのみ)

  • レガシー Alerting(Unified Alerting のみ)

  • Grafana またはデータソースに対する書き込み / ミュート / 一時停止

  • マルチオーガニゼーション対応

  • 埋め込みプロキシを介した Grafana Live / WebSocket プッシュ

インストール

  1. VSIX をビルドします(公開後はリリースアセットも利用可能):

npm install
npm run package   # produces at-grafana-0.1.3.vsix
  1. VS Code / Cursor で: 拡張機能 → ⋯ → VSIX からインストール… を選択し、ファイルを選択します。

  2. AT Grafana アクティビティバービューを開き、AT Grafana: Add Instance を実行します。

クイックスタート

  1. Viewer 権限の Grafana Service Account を作成し、トークンをコピーします。

  2. AT Grafana: Add Instance → ラベル、ベース URL、トークン → 接続テスト → TLS フィンガープリントを確認 → 保存。

  3. ダッシュボード / アラート を閲覧し、ノードをクリックして Webview でネイティブページを開きます。

  4. (オプション、エージェント用)インスタンスを編集し、バックグラウンドエージェントアクセスを許可 を有効にします。

  5. (オプション)AT Grafana: Install/Repair AT Series MCP Config を実行し、MCP クライアントを再接続します。

完全なウォークスルー: docs/usage.md · 中文

エージェントスキル

スキル

目的

at-grafana-mcp

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 ホストが必要です。

ドキュメント

ドキュメント

説明

docs/features.md(中文)

機能概要

docs/usage.md(中文)

セットアップ、エージェントアクセス、MCP クライアント

docs/releases/0.1.3.md

現在のリリースノート(17 ツール MCP カタログ)

docs/releases/0.1.0.md

V1 の Definition-of-Done / 受入記録

docs/requirements.md

完全な要件(中文)

skills/at-grafana-mcp/SKILL.md

エージェント向け MCP カタログガイド

docs/decisions/

ADR-001 … ADR-007

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

段階的実装の履歴

at-terminal-series からスキャフォールド(独立した git 履歴。SSH/SFTP/ターミナルドメインは削除済み)— ADR-001 を参照。

ライセンス

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