mcp-grafana

Grafana MCPサーバーは、Claude DesktopやCursorなどのMCPクライアントをGrafanaインスタンスとその周辺エコシステムに接続するModel Context Protocol（MCP）サーバーです。一部のデータソース操作は新しいAPIエンドポイントに依存するため、完全な機能にはGrafana 9.0以降が必要です。 セットアップは、MCPクライアントの設定にエントリを追加することで行い、通常は環境内のGRAFANA_URLとサービスアカウントトークンを使用してuvx経由でサーバーを実行します。Docker、バイナリ、Helmのインストールオプションも文書化されています。 機能はツールカテゴリにグループ化されており、ツールリストは設定可能なため、未使用の機能を無効にしてコンテキストウィンドウのスペースを節約できます。カテゴリは--disable-oncallや--disable-navigationなどのフラグでオフにでき、いくつかのカテゴリはデフォルトで無効になっており、--enabled-toolsを通じてオプトインする必要があります。 ダッシュボードツールは、タイトル、フォルダUID、タグ、またはスター付きステータスによる検索、UIDまたは保存されたバージョンによるダッシュボードの取得、バージョンの一覧表示、コンパクトなサマリーの取得、JSONPathによる部分抽出、ダッシュボードの作成、更新、パッチ適用、データソース情報を含むパネルクエリの読み取りをカバーします。READMEでは、完全なダッシュボードJSONはコンテキストウィンドウのスペースを大幅に消費する可能性があると指摘し、代わりにサマリーまたはJSONPathツールを推奨しています。 データソースとクエリのサポートには、データソースの一覧表示と検査（Prometheus、Loki、ClickHouse、CloudWatch、Elasticsearch、OpenSearch、Snowflake、Athena）、PromQLのインスタントおよびレンジクエリとメトリクスメタデータおよびヒストグラムパーセンタイル、ラベルとパターン検出を伴うLogQLログおよびメトリクスクエリ、InfluxQLまたはFlux経由のInfluxDB、マクロ置換と制限適用を伴うClickHouse、Snowflake、Athena、MySQL、PostgreSQL、MSSQL用の統合SQLツール、CloudWatch名前空間、メトリクス、ディメンション、Graphiteレンダークエリとメトリクス検出、Elasticsearch/OpenSearchおよびQuickwit検索、サンプルクエリの取得が含まれます。SQLクエリはGrafanaデータソースプラグインを通じて実行されるため、認証情報はMCPサーバーではなくデータソース設定によって処理されます。 運用領域には、アラート（ルールの一覧表示、作成、更新、削除、通知ポリシー、連絡先ポイント、時間間隔）、Grafana Incident（検索、作成、更新、カスタムフィールド）、Sift調査（一覧、詳細、分析、エラーパターンと遅いリクエストの検出）、Grafana OnCall（スケジュール、シフト、現在のオンコールユーザー、チーム、ユーザー、アラートグループ）、アノテーション（クエリ、作成、更新、パッチ、削除、タグ）、スナップショット（一覧、取得、作成、削除）、Grafana Image Renderer経由でのパネルまたはダッシュボードのPNGレンダリング、プロビジョニングリポジトリの一覧表示とドライラン検証、ダッシュボード、パネル、Explore用のディープリンク生成、マルチ組織リクエスト用のユーザーID検索が含まれます。 Grafana Cloud専用のAgent Observabilityツールは、LLM会話の一覧表示と検索、評価スコア付きの会話と生成の詳細、バージョン履歴とトークン推定を伴うエージェントカタログ、評価者とテンプレート、評価ルールとガード、保存された会話とコレクション、テストスイート、オフライン実験をカバーします。これらの一部には、特定の権限の背後でゲートされた書き込み操作が含まれます。Grafana Assistantツールは、自然言語プロンプトをアシスタントに送信し、返されたコンテキストIDを介して会話を継続することをサポートします。これらは書き込みツールであり、--disable-writeが設定されている場合はスキップされます。 アクセス制御はRBACベースです。各ツールには特定の権限とスコープが必要であり、READMEでは必要な付与を持つサービスアカウントを作成することを推奨し、組み込みのEditorロールはより簡単だが粒度が低い代替手段であると述べています。IncidentおよびSiftツールは、細かい権限ではなく基本的なViewer/Editorロールを使用します。READMEには、ツール名をカテゴリ、必要なRBAC権限、必要なスコープにマッピングするツール表が含まれています。