AT Grafana

中文

AT Grafana は AT シリーズ（at-terminal-series および at-jumpserver-series と並ぶ）の VS Code / Cursor 拡張機能です。Grafana のダッシュボードと Unified Alerting を IDE にもたらし、共有の @at-series/mcp-hub Protocol v1 を通じて、読み取り専用の Grafana メタデータとデータソースクエリ（Prometheus、Loki など）をエージェントに公開します。

現在のバージョン: 0.1.0 — V1 の機能はすべて実装済みです。自動テストスイート: 型チェック + 292 件のテスト。実 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 ツールに表示されます

• 9 つの MCP ツール（risk: read、AT Series MCP インストール後に自動承認）:

  • 検出: grafana_list_instances

  • 管理: grafana_list_dashboards、grafana_get_dashboard、grafana_list_folders、grafana_list_alert_rules、grafana_get_alert_rule、grafana_get_alert_history

  • 監視: grafana_list_datasources、grafana_query_datasource（GET/POST のみ。path は /api/datasources/proxy/uid/<uid>/ に制限されるため、Grafana 自身の API には到達できません。時間範囲 / 応答サイズの上限を設定可能）

• 共有 AT Series Hub — Cursor / Kiro / Continue 用の単一の AT Series MCP エントリ。プラグイン固有の MCP サーバーは不要です

Related MCP server: Grafana MCP Server

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

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

• レガシーアラート（Unified Alerting のみ）

• Grafana またはデータソースへの書き込み / ミュート / 一時停止

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

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

インストール

1. VSIX をビルドします（公開後はリリースアセットを使用できます）:

   npm install
   npm run package   # produces at-grafana-0.1.0.vsix

2. VS Code / Cursor で: 拡張機能 → ⋯ → VSIX からインストール… を選択し、ファイルを選択します。

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

クイックスタート

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

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

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

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

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

完全なチュートリアル: docs/usage.md · 中文

エージェントスキル

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

ドキュメント

at-terminal-series からスキャフォールドされています（独立した git 履歴。SSH/SFTP/ターミナル領域は削除済み）— ADR-001 を参照してください。

ライセンス

MIT