MCP Loki

MCP洛基

用于查询Grafana Loki日志的MCP服务器。使LLM能够通过模型上下文协议搜索和分析日志。

特性

• LogQL查询 --执行具有灵活时间范围的范围查询
• 标签发现 --列出用于构建查询的标签及其值
• 系列探索 --查找与标签选择器匹配的日志流
• 索引统计 --获取基数和大小指标
• 提示模板 --用于常见日志分析任务的现成LogQL模式
• 多种身份验证方法 --基本身份验证、承载令牌、多租户（X-Scope-ArgID）
• 多拱形图像 — linux/amd64 和 linux/arm64
• 签名图像 --通过联合签名无密钥签名进行验证

快速开始

容器（Podman/Docker）

添加到MCP客户端配置中：

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

去安装

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查询。

例子：

Query the last hour of nginx error logs:
- query: {app="nginx"} |= "error"
- start: 1h
- limit: 50

loki标签

获取特定标签的标签名称或值。

例子：

Get all label names: (no parameters)
Get values for "app" label: name=app

loki系列

查找与标签选择器匹配的日志流。

例子：

Find all nginx streams: match=["{app=\"nginx\"}"]

loki_stats

获取查询的索引统计信息。

例子：

Get stats for nginx logs: query={app="nginx"}

lokiready

检查Loki是否已准备好接受请求。无需参数。

loki_config

获取YAML格式的Loki服务器配置。无需参数。

可用提示

错误日志

查找特定应用程序的错误日志。

rate_query

计算与选择器匹配的日志行的比率。

top_label_values

按日志量查找标签的前N个值。

时间格式

所有时间参数均接受：

• RFC3339: 2024-01-15T10:30:00Z
• 相对的: 30s, 5m, 1h, 7d （秒、分钟、小时、天前）
• 关键词: now

验证

容器图像使用共同签名无密钥签名进行签名：

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条款