Loki MCP Server

🚀 簡單 Loki MCP 服務器

Loki MCP 服務器是一個用於通過 logcli 查詢 Grafana Loki 日誌的 模型上下文協議 (MCP) 接口。藉助該服務器，AI 助手能夠直接訪問並分析 Loki 的日誌數據。

🚀 快速開始

Loki MCP 服務器是一個用於通過 logcli 查詢 Grafana Loki 日誌的 模型上下文協議 (MCP) 接口。該服務器使 AI 助手能夠直接訪問和分析 Loki 的日誌數據。

✨ 主要特性

• 使用完整的 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": "node",
      "args": ["index.js"],
      "config": {
        "port": 3000,
        "logcliPath": "/usr/local/bin/logcli"
      }
    }
  }
}

💻 使用示例

基礎用法

啟動服務器：

npm start

高級用法

開發模式運行：

npm run dev

🔧 技術細節

自動回退到 HTTP API

服務器會自動檢查 logcli 是否已安裝並可用：

1. 如果 logcli 可用，則所有查詢均使用它，提供與 CLI 工具相同的完整功能
2. 如果 logcli 不可用，服務器將自動回退到使用 Loki HTTP API：
   • 無需額外配置
   • 使用相同的認證參數
   • 響應格式與 CLI 輸出一致
   • 每個查詢默認限制為 1000 條日誌

此自動檢測確保了服務器在不同環境中無縫工作，而無需手動配置。

開發

# 運行代碼檢查
npm run lint

# 修復代碼問題
npm run lint:fix

# 運行測試
npm run test

📄 許可證

本項目根據 MIT 許可證發佈 - 有關詳細信息，請參閱 LICENSE.md 文件。