Grafana MCP SSE Server

📊 aimiox Grafana MCP

aimiox MCP Grafana SSE Serverを使うと、Model Context Protocol (MCP)経由でGrafanaのダッシュボードやパネルを簡単に検索できます。自然言語でのクエリ、ダッシュボードの監視、リアルタイムのデータ抽出が可能です。

MCP対応クライアント（amx-chatなど）をGrafanaのAPIに接続する、軽量なコンテナです。

---

🚀 クイックスタート（Docker経由）

sudo docker run -p 8010:8010 \
  -e GRAFANA_API_KEY="YOUR_KEY" \
  -e GRAFANA_URL="https://grafana.example.com" \
  aimiox/amx-mcp-grafana:latest

🧠 読み取り専用アクセス権を持つGrafanaサービスアカウントのAPIキーを使用できます。

🔑 サービスアカウントを使ったGrafana APIキーの作成方法をご覧ください。

⚙️ 環境変数

変数	説明
GRAFANA_URL	Grafanaインスタンスの完全なURL（例：https://grafana.example.com）
GRAFANA_API_KEY	有効なAPIキー（サービスアカウント経由で作成）

---

🧠 できること

このMCPプラグインを使うと、次の操作ができます。

• 🔎 名前でダッシュボードを検索
• 📋 任意のダッシュボード内のパネルを一覧表示
• 📊 自然言語でパネルデータをクエリ
• ✅ 無料プランでのPrometheusパネルクエリに対応

---

💎 プレミアム機能

無料版では、Prometheusパネルのみクエリできます。

有料版では、次のサービスにも対応します。

• PostgreSQL
• Loki
• MySQL
• InfluxDB
• Elasticsearch
• …その他！

🛠️ 有料アクセスまたはカスタム統合については、メールでお問い合わせください

🧩 統合例

MCP対応クライアントをGrafana MCPサーバーに接続するには、次の設定を使用してください。

  url: "http://mcp-docker-server-ip:8010/sse?amx_mcp_key=aimiox-public-mcp-key"

💡 mcp-docker-server-ipを、MCPサーバーコンテナの実際のIPアドレスまたはホスト名に置き換えてください。

この設定により、MCP SSE経由でGrafanaインスタンスとリアルタイムにやり取りできます。

💬 プロンプトの例

MCPクライアントで使用できる自然言語クエリの例を以下に示します。

• 🔍 「名前にCPUを含むダッシュボードをすべて一覧表示してください。」
• 📊 「Mobile CoreダッシュボードからCPU使用率パネルをクエリしてください。」

---

🤖 応答例（GPT-4.1-mini経由）

ユーザーのプロンプト：

Mobile CoreダッシュボードからCPU使用率パネルをクエリしてください

AIの応答：

Mobile CoreダッシュボードのCPU使用率パネル（「CPU 5-min Load」）には、過去6時間のCPU負荷値が5分間隔で記録されています。

この期間の主なデータポイントは次のとおりです。

• 負荷値は変動しており、10、11、24、23、一部の時点では最大34となっています。
• 最新のデータポイントである**「2025-04-17 15:50:00」の負荷値は23**です。

特定の値の詳細や、さらに分析が必要な場合はお知らせください！

📣 サポート

質問、問題、貢献については、github.com/aimioxでissueを作成するか、メールでお問い合わせください