MCP Loki

🚀 MCP Loki

MCP Lokiは、Grafana LokiのログをクエリするためのMCPサーバーです。Model Context Protocolを介して、LLMがログを検索および分析できるようにします。

✨ 主な機能

• LogQLクエリ — 柔軟な時間範囲で範囲クエリを実行します。
• ラベル検出 — クエリ構築のためにラベルとその値をリストします。
• シリーズ探索 — ラベルセレクターに一致するログストリームを見つけます。
• インデックス統計 — カーディナリティとサイズのメトリクスを取得します。
• 複数の認証方法 — 基本認証、ベアラートークン、マルチテナント（X-Scope-OrgID）。
• マルチアーキテクチャイメージ — linux/amd64 と linux/arm64。
• 署名付きイメージ — cosignのキーレス署名で検証されています。

🚀 クイックスタート

コンテナ (Podman/Docker)

MCPクライアントの設定に追加します。

{
  "mcpServers": {
    "loki": {
      "command": "podman",
      "args": [
        "run", "--rm", "-i",
        "-e", "LOKI_URL=http://loki:3100",
        "ghcr.io/lexfrei/mcp-loki:latest"
      ]
    }
  }
}

Goインストール

go install github.com/lexfrei/mcp-loki/cmd/mcp-loki@latest

MCPクライアントの設定:

{
  "mcpServers": {
    "loki": {
      "command": "mcp-loki",
      "env": {
        "LOKI_URL": "http://loki:3100"
      }
    }
  }
}

📚 ドキュメント

設定

すべての設定は環境変数を介して行われます。

認証の例

認証なし（ローカルLoki）:

{
  "command": "podman",
  "args": [
    "run", "--rm", "-i",
    "-e", "LOKI_URL=http://loki:3100",
    "ghcr.io/lexfrei/mcp-loki:latest"
  ]
}

基本認証:

{
  "command": "podman",
  "args": [
    "run", "--rm", "-i",
    "-e", "LOKI_URL=https://loki.example.com",
    "-e", "LOKI_USERNAME=admin",
    "-e", "LOKI_PASSWORD=secret",
    "ghcr.io/lexfrei/mcp-loki:latest"
  ]
}

ベアラートークン（Grafana Cloud）:

{
  "command": "podman",
  "args": [
    "run", "--rm", "-i",
    "-e", "LOKI_URL=https://logs-prod-us-central1.grafana.net",
    "-e", "LOKI_TOKEN=glc_xxx",
    "-e", "LOKI_ORG_ID=123456",
    "ghcr.io/lexfrei/mcp-loki:latest"
  ]
}

利用可能なツール

loki_query

Lokiに対してLogQLクエリを実行します。

例:

過去1時間のnginxエラーログをクエリする:
- query: {app="nginx"} |= "error"
- start: 1h
- limit: 50

loki_labels

特定のラベルのラベル名または値を取得します。

例:

すべてのラベル名を取得する: （パラメータなし）
"app" ラベルの値を取得する: name=app

loki_series

ラベルセレクターに一致するログストリームを見つけます。

例:

すべてのnginxストリームを見つける: match=["{app=\"nginx\"}"]

loki_stats

クエリのインデックス統計を取得します。

例:

nginxログの統計を取得する: query={app="nginx"}

時間フォーマット

すべての時間パラメータは以下を受け付けます。

• RFC3339: 2024-01-15T10:30:00Z
• 相対時間: 30s, 5m, 1h, 7d（秒、分、時間、日前）
• キーワード: now

検証

コンテナイメージはcosignのキーレス署名で署名されています。

cosign verify ghcr.io/lexfrei/mcp-loki:latest \
  --certificate-identity-regexp=https://github.com/lexfrei/mcp-loki \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com

📄 ライセンス

BSD-3-Clause