Loki MCP

🚀 Loki MCP 服務器

Loki MCP 服務器是一款用於與 Grafana Loki 集成的工具，支持通過命令行或配置進行交互，為用戶提供便捷的操作體驗。

🚀 快速開始

要使用 Loki MCP 服務器，請按照以下步驟操作：

1. 克隆倉庫：

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

2. 構建二進制文件（可選）：

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

3. 運行服務器：

   ./loki-mcp-server
   

✨ 主要特性

• 支持與 Grafana Loki 集成，可通過命令行或配置進行交互。
• 提供豐富的命令行參數，方便用戶靈活配置。
• 支持 Docker 部署，便於快速搭建和使用。
• 可與 Claude Desktop 和 Cursor 等工具集成。

📦 安裝指南

本地安裝

1. 克隆倉庫：

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

2. 構建二進制文件（可選）：

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

3. 運行服務器：

   ./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 服務器，請按照以下步驟操作：

1. 構建二進制文件：

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

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

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

3. 配置位置：
   • 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"]
    }
  }
}

📄 許可證

本項目使用 MIT 許可證，詳情請查看 LICENSE 文件。

如果有任何問題，請隨時提交 Issue 或 Pull Request。