🚀 简单 Loki MCP 服务器
Loki MCP 服务器是一个 模型上下文协议 (MCP) 接口，可通过 logcli 查询 Grafana Loki 日志。借助该服务器，AI 助手能够直接访问并分析 Loki 的日志数据。
🚀 快速开始
若要通过 Smithery 自动安装 Simple Loki MCP Server for Claude Desktop，可使用以下命令：
npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude
启动服务器：
npm start
开发模式运行：
npm run dev
✨ 主要特性
- 使用完整的 LogQL 支持查询 Loki 日志
- 获取标签值和元数据
- 通过环境变量或配置文件支持身份验证和配置
- 提供不同输出格式的结果（默认、原始、JSON 线）
- 在环境中未安装
logcli时自动回退到 HTTP API
📦 安装指南
使用 Smithery 安装
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 是否已安装并可用：
- 如果
logcli可用，则所有查询均使用它，提供与 CLI 工具相同的完整功能 - 如果
logcli不可用，服务器将自动回退到使用 Loki HTTP API：- 无需额外配置
- 使用相同的认证参数
- 响应格式与 CLI 输出一致
- 每个查询默认限制为 1000 条日志
此自动检测确保了服务器在不同环境中无缝工作，而无需手动配置。
📄 许可证
本项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE.md 文件。