MCP Grafana

🚀 Grafana 使用ドキュメント

Grafana は機能豊富なオープンソースの監視と可視化プラットフォームで、複数のデータソースをサポートし、豊富なグラフとアラート機能を提供します。Model Context Protocol (MCP) との統合を容易にするために、mcp-grafana ツールが提供されており、MCP プロトコルを通じて Grafana サービスとのやり取りが可能です。

🚀 クイックスタート

このセクションでは、Grafana と mcp-grafana ツールの基本的な使い方を説明します。

✨ 主な機能

• Grafana は機能強化されたオープンソースの監視と可視化プラットフォームです。
• 複数のデータソースをサポートし、豊富なグラフとアラート機能を提供します。
• mcp-grafana ツールを通じて MCP プロトコルで Grafana サービスとのやり取りが可能です。

📦 インストール

1. サービスアカウントの作成と API Token の取得

Grafana でサービスアカウントを作成し、必要なツールを使用するための十分な権限を付与します。サービスアカウントトークンを生成し、クリップボードにコピーして、後の設定で使用します。詳細な手順は Grafana ドキュメント を参照してください。

2. mcp-grafana のダウンロードとインストール

リリースページ から最新バージョンの mcp-grafana をダウンロードし、システムパスに追加します。Go ツールチェーンを使用する場合は、以下のコマンドでインストールできます。

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 の完全なパスを指定する必要があります。

💻 使用例

基本的な使用法

上記のインストールと設定を行った後、Grafana と mcp-grafana を使用できます。

高度な使用法

デバッグモードの有効化

-debug フラグを追加することで、詳細な HTTP リクエストとレスポンスのログを取得できるデバッグモードを有効化できます。Claude Desktop の設定を以下のように更新します。

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["-debug"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_API_KEY": "<your service account token>"
      }
    }
  }
}

🔧 技術詳細

開発

このプロジェクトは Go で記述されています。Go をインストールするには、対応するプラットフォームの説明を参照してください。

サーバーを実行するには、以下のコマンドを実行します。

make run

また、SSE トランスポートを使用して Docker 内で実行することもできます。

make build-image

docker run -it --rm -p 8000:8000 mcp-grafana:latest

テスト

3 種類のテストがあります。

1. 単体テスト：個々の関数の動作を検証します。
2. 統合テスト：コンポーネント間の相互作用をテストします。
3. クラウドテスト：クラウド環境で実行されるテストです。 テストを実行する際には、以下の要件と手順に注意してください。

📄 ライセンス

このプロジェクトは MIT License に従っており、自由に使用、変更、配布することができますが、著作権表示を保持する必要があります。