Grafana MCP サーバー

Grafana 用のモデル コンテキスト プロトコル(MCP) サーバー。

これにより、Grafana インスタンスと周囲のエコシステムにアクセスできるようになります。

特徴

• [x] ダッシュボードを検索
• [x] UIDでダッシュボードを取得する
• [x] データソース情報の一覧表示と取得
• [ ] データソースのクエリ
  • [x] プロメテウス
  • [x] ロキ
    • [x] ログクエリ
    • [x] メトリッククエリ
  • [ ] テンポ
  • [ ] パイロスコープ
• [x] Prometheusメタデータのクエリ
  • [x] メトリックメタデータ
  • [x] メトリック名
  • [x] ラベル名
  • [x] ラベル値
• [x] Lokiメタデータのクエリ
  • [x] ラベル名
  • [x] ラベル値
  • [x] 統計
• [x] インシデントの検索、作成、更新、クローズ
• [ ] Sift調査を開始して結果を表示する
• [ ] 警告
  • [x] アラートルール情報の一覧表示と取得
  • [x] アラートルールのステータス（実行中/正常/エラーなど）を取得します。
  • [ ] アラートルールの作成と変更
  • [x] 連絡先リスト
  • [ ] 連絡先の作成と変更
• [x] Grafana OnCall機能にアクセスする
  • [x] スケジュールの一覧表示と管理
  • [x] シフトの詳細を取得する
  • [x] 現在のオンコールユーザーを取得する
  • [x] チームとユーザーの一覧
  • [ ] アラートグループの一覧

ツールリストは設定可能なので、MCPクライアントで利用できるようにするツールを選択できます。これは、特定の機能を使用しない場合や、コンテキストウィンドウをあまり占有したくない場合に便利です。特定のカテゴリのツールを無効にするには、サーバーの起動時に--disable-<category>フラグを使用します。例えば、OnCallツールを無効にするには、 --disable-oncallを使用します。

ツール

使用法

1. Grafanaで、必要なツールを使用するのに十分な権限を持つサービスアカウントを作成し、サービスアカウントトークンを生成して、設定ファイルで使用するためにクリップボードにコピーします。詳細については、 Grafanaのドキュメントを参照してください。
2. リリース ページからmcp-grafanaの最新リリースをダウンロードし、 $PATHに配置します。Goツールチェーンがインストールされている場合は、 GOBIN環境変数を使用してバイナリをインストールするディレクトリを指定し、ソースからビルドしてインストールすることもできます。このディレクトリはPATHにも含まれている必要があります。
   GOBIN="$HOME/go/bin" go install github.com/grafana/mcp-grafana/cmd/mcp-grafana@latest
3. サーバー設定をクライアント設定ファイルに追加します。例えば、Claude Desktopの場合は以下のようになります。
   { "mcpServers": { "grafana": { "command": "mcp-grafana", "args": [], "env": { "GRAFANA_URL": "http://localhost:3000", "GRAFANA_API_KEY": "<your service account token>" } } } }

注意: Claude Desktop でError: spawn mcp-grafana ENOENT表示される場合は、 mcp-grafanaへのフルパスを指定する必要があります。

デバッグモード

コマンドに-debugフラグを追加することで、Grafana トランスポートのデバッグモードを有効にできます。これにより、MCP サーバーと Grafana API 間の HTTP リクエストとレスポンスの詳細なログが記録され、トラブルシューティングに役立ちます。

Claude Desktop 構成でデバッグ モードを使用するには、次のように構成を更新します。

発達

貢献を歓迎します！ご提案や改善点がありましたら、問題を報告するか、プルリクエストを送信してください。

このプロジェクトはGoで書かれています。お使いのプラットフォームの指示に従ってGoをインストールしてください。

サーバーを実行するには、次を使用します。

Docker内でSSEトランスポートを使用してサーバーを実行することもできます。イメージをビルドするには、

イメージを実行するには、次を使用します。

テスト

利用できるテストには 3 つの種類があります。

1. ユニットテスト (外部依存関係は不要):

次のようにしてユニット テストを実行することもできます。

2. 統合テスト (Docker コンテナが起動して実行されている必要があります):

3. クラウド テスト (クラウド Grafana インスタンスと認証情報が必要です):

注: クラウドテストはCIで自動的に構成されます。ローカル開発の場合は、独自のGrafana Cloudインスタンスと認証情報を設定する必要があります。

より包括的な統合テストでは、Grafana インスタンスをポート 3000 でローカルに実行する必要があります。これは Docker Compose で起動できます。

統合テストは次のように実行できます。

ツールを追加する場合は、それらの統合テストを追加してください。既存のテストは良い出発点となるはずです。

リンティング

コードを lint するには、次を実行します。

これには、 jsonschema構造体タグ内のエスケープされていないカンマをチェックするカスタムリンターが含まれています。 descriptionフィールド内のカンマは\\,でエスケープする必要があります。このリンターだけを実行するには、次のコマンドを使用します。

詳細については、 JSONSchema Linter のドキュメントを参照してください。

ライセンス

このプロジェクトは、Apache License バージョン 2.0に基づいてライセンスされます。