Grafana MCP

Grafana MCP

このプロジェクトは、Grafana のダッシュボード、データソース、アラートなどと連携する MCP ツールを含む、Grafana 用の MCP サーバーを提供します。

このパッケージには、インストール後に使用できるよう、ダッシュボードテンプレートのリソースが適切に同梱されています。

使用方法

インストール

1. 仮想環境を作成します（推奨）

python -m venv venv
source venv/bin/activate

2. pip を使って、このパッケージを GitHub から直接インストールします。

pip install -e git+https://github.com/izaitsevfb/grafana-mcp.git#egg=grafana_mcp

（代わりに、pip install -e . を使ってローカルにインストールすることもできます）

3. Grafana 認証を設定します

Grafana の URL と API トークンを記述した .env ファイルを作成します。

cp .env.example .env

次に、.env ファイルを編集して、実際の Grafana URL と API トークンを追加します。

GRAFANA_URL=http://your-grafana-server:3000
GRAFANA_API_TOKEN=your-api-token-here

Grafana で Configuration → API Keys → New API key に移動すると、API トークンを生成できます。

4. インストール後、MCP サーバーは次のように実行できます。

python -m grafana_mcp

5. この MCP サーバーを Claude Code に追加します。

claude mcp add-json grafana '{ "type": "stdio", "command": "python", "args": [ "-m", "grafana_mcp" ], "env": {} }'

注：デフォルトでは、MCP の設定は現在のディレクトリにのみ適用されます。グローバルに使用する場合は、上記のコマンドに --scope user を追加してください。

claude mcp add-json --scope user grafana '{ "type": "stdio", "command": "python", "args": [ "-m", "grafana_mcp" ], "env": {} }'

6. 通常どおり Claude Code を実行します。

claude

開発

開発用インストール

1. リポジトリをクローンします
2. 開発モードでインストールします。

   pip install -e .
   

このパッケージでは、Python のパッケージリソース管理システムを使ってダッシュボードテンプレートを同梱しています。dashboard.json ファイルは src/grafana_mcp/ ディレクトリに保存され、パッケージのインストール時には importlib.resources を使ってアクセスされます。

テスト

ユニットテストを実行します。

python -m unittest discover tests

トークン認証を使ってテストするには、上記の説明に従い、Grafana の認証情報を記述した .env ファイルを作成しておいてください。テストスイートには、実際の Grafana インスタンスを必要としないモックテストが含まれています。

ツール

Grafana MCP は、次のツールを提供します。

利用可能なツール

ダッシュボード管理

• get_grafana_info(): 接続中の Grafana インスタンスに関する情報（バージョンや接続状態など）を取得します
• list_dashboards(): 接続中の Grafana インスタンスにあるすべてのダッシュボードを一覧表示します
• get_dashboard(uid): UID を指定して、特定のダッシュボードの詳細を取得します

組織管理

• get_organization(): 現在の組織に関する情報を取得します

データソース管理

• list_datasources(): 利用可能なすべてのデータソースを一覧表示します

要件

• grafana-client: Grafana API 用の Python クライアント
• python-dotenv: .env ファイルから環境変数を読み込むためのライブラリ
• mcp: Model Context Protocol サーバーの実装

認証

このパッケージは、Grafana API のトークン認証を使用します。認証を設定するには、次の手順に従います。

1. Grafana インスタンスで、適切な権限を持つ API キーを作成します
2. 次の変数を記述した .env ファイルを作成します。

   GRAFANA_URL=http://your-grafana-url:3000
   GRAFANA_API_TOKEN=your-api-token-here
   

3. MCP サーバーは起動時にこれらの認証情報を自動的に読み込みます

今後のバージョンで、さらにツールや機能を追加する予定です。