简单的 Loki MCP 服务器

Loki MCP 服务器是一个模型上下文协议 (MCP)接口，用于使用logcli查询 Grafana Loki 日志。该服务器使 AI 助手能够直接访问和分析来自 Loki 的日志数据。

特征

使用完整的 LogQL 支持查询 Loki 日志
获取标签值和元数据
通过环境变量或配置文件进行身份验证和配置支持
提供不同输出格式的格式化结果（默认、原始、JSON 行）

先决条件

Node.js v16 或更高版本
TypeScript
Grafana Loki logcli已安装并可在您的 PATH 中访问
访问 Loki 服务器实例

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Simple Loki MCP 服务器：

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/loki-mcp.git
cd loki-mcp

安装依赖项：

npm install

构建项目：

npm run build

可用的 MCP 工具

查询-loki

使用过滤选项查询 Loki 的日志。

参数：

query （必需）：Loki 查询字符串（LogQL）
from ：开始时间戳（例如“2023-01-01T12：00：00Z”）
to ：结束时间戳（例如“2023-01-01T13：00：00Z”）
limit ：返回的最大日志数量
batch ：查询结果的批次大小
output ：输出格式（“默认”、“原始”或“jsonl”）
quiet ：抑制查询元数据
forward ：按时间顺序显示结果

获取标签值

检索特定标签的所有值。

参数：

label （必需）：获取值的标签名称

获取标签

检索所有可用的标签。

无需任何参数。

配置

您可以使用以下方式配置 Loki 访问：

环境变量

LOKI_ADDR ：Loki 服务器地址（URL）
LOKI_USERNAME ：基本身份验证的用户名
LOKI_PASSWORD ：基本身份验证的密码
LOKI_TENANT_ID ：多租户 Loki 的租户 ID
LOKI_BEARER_TOKEN ：用于身份验证的承载令牌
LOKI_BEARER_TOKEN_FILE ：包含持有者令牌的文件
LOKI_CA_FILE ：TLS 的自定义 CA 文件
LOKI_CERT_FILE ：TLS 的客户端证书文件
LOKI_KEY_FILE ：TLS 的客户端密钥文件
LOKI_ORG_ID ：多组织设置的组织 ID
LOKI_TLS_SKIP_VERIFY ：跳过 TLS 验证（“true”或“false”）
LOKI_CONFIG_PATH ：配置文件的自定义路径
DEBUG ：启用调试日志记录

配置文件

或者，在以下位置之一创建logcli-config.yaml文件：

LOKI_CONFIG_PATH指定的自定义路径
当前工作目录
您的主目录（ ~/.logcli-config.yaml ）

示例配置文件：

addr: https://loki.example.com
username: user
password: pass
tenant_id: mytenant

用法

启动服务器：

npm start

对于开发：

npm run dev

发展

# Run linter
npm run lint

# Fix linting issues
npm run lint:fix

# Run tests
npm run test

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE.md文件。

Loki MCP Server

Integrations