MCP Loki

🚀 MCP Loki

MCP Loki 是一個用於查詢 Grafana Loki 日誌的 MCP 服務器。它藉助模型上下文協議，讓大語言模型（LLMs）能夠搜索和分析日誌，極大提升了日誌處理和分析的效率。

✨ 主要特性

• LogQL 查詢：可執行具有靈活時間範圍的範圍查詢。
• 標籤發現：列出標籤及其值，方便構建查詢。
• 系列探索：查找與標籤選擇器匹配的日誌流。
• 索引統計：獲取基數和大小指標。
• 多種認證方式：支持基本認證、Bearer 令牌、多租戶（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"
  ]
}

Bearer 令牌（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 查詢。

示例：

查詢最近一小時的 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 許可證。