Loki MCP

一个基于Go语言的MCP协议服务器实现，集成了Grafana Loki日志查询功能，支持通过标准输入输出与客户端通信，并提供Docker部署方式。

监控开发者工具 #日志查询 #MCP协议 #Golang服务 #Loki集成 .Go

评分 : 2.5分

下载量 : 8.3K

更新时间 : 2025-04-28

打开站点

什么是Loki MCP服务器？

Loki MCP 服务器是一个连接您的 AI 模型与互联网的桥梁，使模型能够实时访问和理解网络上的信息。通过配置合适的插件，模型可以联网搜索、验证身份或执行其他在线任务。

主要特点

Loki MCP 服务器支持多种插件系统，允许模型扩展功能；提供安全的身份验证机制；能够处理各种网络协议和 API 调用。

应用场景

适用于需要实时信息检索的任务、在线服务集成以及复杂网络操作的场景。例如，问答系统、实时数据分析和自动化脚本编写等。

功能特性

插件支持

支持多种网络服务的插件，如HTTP 请求、DNS 查询和身份验证模块。

安全机制

内置的身份验证和权限管理功能，确保模型的安全使用。

高扩展性

模块化设计允许轻松添加新功能和适配不同服务接口。

使用指南

安装服务器

从官方仓库下载最新版本并安装到您的系统中。

配置插件

根据需要安装和配置各种功能插件，如HTTP 客户端或身份验证模块。

设置权限

为确保安全，建议配置访问控制列表和认证机制。

常见问题解答

如何处理服务器的安全漏洞？

插件之间会有冲突吗？

🚀 Loki MCP 服务器

Loki MCP 服务器是一款用于与 Grafana Loki 集成的工具，支持通过命令行或配置进行交互，为用户提供便捷的操作体验。

🚀 快速开始

要使用 Loki MCP 服务器，请按照以下步骤操作：

克隆仓库：

git clone https://github.com/your-repository.git
cd loki-mcp-server

构建二进制文件（可选）：

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

运行服务器：
```
./loki-mcp-server
```

✨ 主要特性

支持与 Grafana Loki 集成，可通过命令行或配置进行交互。
提供丰富的命令行参数，方便用户灵活配置。
支持 Docker 部署，便于快速搭建和使用。
可与 Claude Desktop 和 Cursor 等工具集成。

📦 安装指南

本地安装

克隆仓库：

git clone https://github.com/your-repository.git
cd loki-mcp-server

构建二进制文件（可选）：

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

运行服务器：
```
./loki-mcp-server
```

Docker 安装

构建镜像

# Dockerfile
FROM golang:1.20 AS builder

WORKDIR /app
COPY go.mod .
COPY go.sum .
RUN go mod tidy

COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -o loki-mcp-server ./cmd/server

FROM alpine:3.18
WORKDIR /app
COPY --from=builder /app/loki-mcp-server .

CMD ["./loki-mcp-server"]

运行容器

docker build -t loki-mcp-server .
docker run -it loki-mcp-server

💻 使用示例

命令行参数

Loki MCP 服务器支持以下命令行参数：

-config: 指定配置文件路径（默认为 config.json）。
-log.level: 设置日志级别（可选值：debug, info, warning, error）。

示例用法

基础用法

# 查询 Loki 数据
./loki-mcp-server query --expr "{job=\"varlogs\"}"

高级用法

# 获取 Loki 日志
./loki-mcp-server logs -selector "job=varlogs"

📚 详细文档

项目结构

cmd/server: 包含 MCP 服务器的主程序。
internal/handlers/loki.go: Grafana Loki 查询功能实现。
internal/handlers/types.go: 定义了处理程序的通用类型和接口。

与其他工具集成

与 Claude Desktop 集成

要在 Claude Desktop 中使用 Loki MCP 服务器，请按照以下步骤操作：

构建二进制文件：

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

配置文件示例（claude_desktop_config.json）：

{
  "mcpServers": {
    "lokiserver": {
      "command": "path/to/loki-mcp-server",
      "args": [],
      "env": {
        "LOKI_URL": "http://localhost:3100"
      },
      "disabled": false,
      "autoApprove": ["loki_query"]
    }
  }
}

配置位置：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

与 Cursor 集成

要在 Cursor 中使用 Loki MCP 服务器，请在配置文件中添加以下内容：

{
  "mcpServers": {
    "loki-mcp-server": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "LOKI_URL=http://host.docker.internal:3100", "loki-mcp-server:latest"]
    }
  }
}