Simple Loki MCP Server

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

特性

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

前提条件

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

安装

1. 克隆存储库：

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

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

配置

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

环境变量

• LOKI_ADDR: Loki 服务器地址 (URL)
• LOKI_USERNAME: 用于基本身份验证的用户名
• LOKI_PASSWORD: 用于基本身份验证的密码
• LOKI_TENANT_ID: 用于多租户 Loki 的租户 ID
• LOKI_BEARER_TOKEN: 用于身份验证的 Bearer 令牌
• LOKI_BEARER_TOKEN_FILE: 包含 Bearer 令牌的文件
• 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

可用的 MCP 工具

query-loki

从 Loki 查询带有过滤选项的日志。

参数：

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

get-label-values

检索特定标签的所有值。

参数：

• label (必需): 要获取值的标签名称

get-labels

检索所有可用的标签。

无需参数。

开发

# 运行 linter
npm run lint

# 修复 linting 问题
npm run lint:fix

# 运行测试
npm run test

许可证

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