Loki MCP Server

基本能力

产品定位

Loki MCP Server 是一个日志查询服务，专注于通过 MCP 协议提供 Grafana Loki 的日志查询功能。

核心功能

1. 实现 Model Context Protocol (MCP) 服务器
2. 提供 Loki 日志查询工具
3. 支持多种部署方式（二进制、Docker、Go 直接运行）
4. 可与 Claude Desktop 和 Cursor 编辑器集成

适用场景

1. 在 MCP 兼容环境中查询 Loki 日志
2. 与 Claude Desktop 集成进行日志分析
3. 在 Cursor 编辑器中直接查询日志
4. 本地开发和测试 Loki 查询

工具列表

1. loki_query 工具：
2. 功能：查询 Grafana Loki 日志数据
3. 参数：
   • 必需：query (LogQL 查询字符串)
   • 可选：url (Loki 服务器 URL)、start (开始时间)、end (结束时间)、limit (返回条目限制)

常见问题解答

1. 如何与 Claude Desktop 集成？
2. 提供多种配置方式（二进制、脚本、Docker）
3. 需要修改 Claude Desktop 配置文件
4. 如何测试本地 Loki 查询？
5. 使用提供的 Docker Compose 设置启动本地 Loki 环境
6. 使用 test-loki-query.sh 和 insert-loki-logs.sh 脚本进行测试

使用教程

使用依赖

• Go 1.16 或更高版本

安装教程

1. 从源代码构建：

go build -o loki-mcp-server ./cmd/server

1. 直接运行：

go run ./cmd/server

1. Docker 方式：

docker build -t loki-mcp-server .
docker run --rm -i loki-mcp-server

调试方式

1. 使用测试客户端：

go build -o loki-mcp-client ./cmd/client
./loki-mcp-client loki_query "{job=\"varlogs\"}"

1. 本地测试环境：

docker-compose up -d
./test-loki-query.sh '{job="varlogs"} |= "ERROR"'
./insert-loki-logs.sh --num 20 --job "custom-job"

许可证

该项目遵循 MIT 开源许可条款。