🚀 简单 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：要执行的日志查询。