JinDaGe - loki-mcp MCP Details

article

README

🚀 简单 Loki MCP 服务器

简单 Loki MCP 服务器是一个模型上下文协议 (MCP) 接口，可借助 logcli 对 Grafana Loki 日志进行查询。它让 AI 助手能够直接访问并分析 Loki 的日志数据，为日志处理和分析带来便利。

🚀 快速开始

本服务器允许你通过 logcli 对 Grafana Loki 日志进行查询，让 AI 助手能直接访问和分析日志数据。你可依据以下步骤进行安装和使用。

✨ 主要特性

📋 使用完整的 LogQL 支持查询 Loki 日志。
🔍 获取标签值和元数据。
🔐 通过环境变量或配置文件支持身份验证和配置。
📄 提供不同输出格式的格式化结果（默认、原始、JSON 线）。
⚙️ 在 logcli 环境不可用时自动回退到 HTTP API。

📦 安装指南

先决条件

Node.js v16 或更高版本。
TypeScript。
(可选) 安装并可在 PATH 中访问的 Grafana Loki logcli。若 logcli 不可用，服务器将自动使用 Loki HTTP API。
对 Loki 服务器实例的访问。

安装方式

通过 Smithery 安装

要通过 Smithery 自动安装 Simple Loki MCP Server for Claude Desktop，可执行以下命令：

npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude

对于 MCP

在配置文件中添加如下内容：

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "https://loki.sup.band"
      }
    }
  }
}

npm

按以下步骤操作：

克隆仓库：

git clone https://github.com/ghrud92/simple-loki-mcp.git
cd simple-loki-mcp
npm install

📚 详细文档

可用的 MCP 工具

`simple-loki`

描述

用于查询和分析 Loki 日志。

参数

--addr 或 -a：指定 Loki 服务器的地址（默认值：http://localhost:3100）。
--query 或 -q：要执行的日志查询。

loki-mcp