Grafana Loki MCP

🚀 Grafana-Loki MCP サーバー

Grafana-Loki MCP サーバーは、FastMCP をベースとしたサーバーで、Grafana を通じて Loki のログをクエリすることができます。

🚀 クイックスタート

Grafana-Loki MCP サーバーを使用することで、Grafana を通じて Loki のログを簡単にクエリできます。以下に基本的な手順を示します。

✨ 主な機能

• Loki ログのクエリ
• ログ内のラベルと値の取得
• クエリ結果のフォーマット（テキスト、JSON、Markdown をサポート）
• stdio と SSE の2種類の伝送プロトコルをサポート

📦 インストール

pip を使用する場合

pip install grafana-loki-mcp

開発環境の場合

1. リポジトリをクローンします。

   git clone https://github.com/tumf/grafana-loki-mcp.git
   cd grafana-loki-mcp
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. テストを実行します。

   python -m pytest tests/
   

💻 使用例

環境変数の設定

以下の環境変数を設定します。

export GRAFANA_URL="http://localhost:3000"
export GRAFANA_API_KEY="your_api_key_here"

コマンドライン引数の使用

サーバーを起動します。

grafana-loki-mcp --config config.yaml

サンプル設定ファイル config.yaml

mcpServers:
  loki:
    command: uvx
    args:
      - grafana-loki-mcp
      - -u
      - http://localhost:3000
      - -k
      - your_api_key_here

基本的な使用法

import asyncio
from pygql import client

async def main():
    # クライアントを初期化します。
    cli = await client("http://localhost:8090")
    
    # ログをクエリします。
    results = await cli.call(
        "query_loki",
        {
            "query": '{app="my-app"} |= "error"',
            "limit": 50,
            "max_per_line": 100,
            "start": "now-6h",
            "end": "now"
        }
    )
    
    # 結果をフォーマットします。
    formatted = await cli.call(
        "format_loki_results",
        {
            "results": results,
            "format_type": "markdown",
            "max_per_line": 100
        }
    )
    
    print(formatted)

asyncio.run(main())

📚 ドキュメント

詳細な情報については、公式ドキュメント を参照してください。

🔧 技術詳細

MCP サーバーの設定

{
  "mcpServers": {
    "loki": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

• GRAFANA_URL: あなたの Grafana インスタンスの URL
• GRAFANA_API_KEY: 必要な権限を持つ Grafana API キー

利用可能なツール

ログのクエリ (query_loki)

{
    "query": "{app=\"my-app\"} |= \"error\"",
    "limit": 50,
    "max_per_line": 100,
    "start": "now-6h",
    "end": "now"
}

ラベルの取得 (get_loki_labels)

{
    "query": "{__name__}"
}

結果のフォーマット (format_loki_results)

{
    "results": "...",
    "format_type": "markdown",
    "max_per_line": 100
}

開発

テスト

テストスイートを実行します。

pytest tests/ -v

コード規約

以下のツールを使用してコード規約を確保します。

• black でコードをフォーマット
• flake8 でコードエラーをチェック
• mypy で静的型チェック

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。