Loki MCP Server

🚀 简单 Loki MCP 服务器

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

🚀 快速开始

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

✨ 主要特性

• 使用完整的 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": "node",
      "args": ["index.js"],
      "config": {
        "port": 3000,
        "logcliPath": "/usr/local/bin/logcli"
      }
    }
  }
}

💻 使用示例

基础用法

启动服务器：

npm start

高级用法

开发模式运行：

npm run dev

🔧 技术细节

自动回退到 HTTP API

服务器会自动检查 logcli 是否已安装并可用：

1. 如果 logcli 可用，则所有查询均使用它，提供与 CLI 工具相同的完整功能
2. 如果 logcli 不可用，服务器将自动回退到使用 Loki HTTP API：
   • 无需额外配置
   • 使用相同的认证参数
   • 响应格式与 CLI 输出一致
   • 每个查询默认限制为 1000 条日志

此自动检测确保了服务器在不同环境中无缝工作，而无需手动配置。

开发

# 运行代码检查
npm run lint

# 修复代码问题
npm run lint:fix

# 运行测试
npm run test

📄 许可证

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