Loki MCP 服务器

“Loki” MCP 服务器能做什么？

Loki MCP 服务器是基于 Go 的 Model Context Protocol (MCP) 实现，旨在与日志聚合系统 Grafana Loki 集成。它作为 AI 助手与外部日志数据源之间的桥梁，使 AI 能够查询和交互存储于 Loki 的日志流。通过 MCP 协议暴露 Loki 的查询能力，开发者和 AI 客户端可以增强工作流，例如直接通过标准化的 LLM 接口进行日志搜索、过滤和分析。这为实时日志调查、故障排查和仪表盘创建等任务提供了无缝的运维数据访问，实现可观测性和自动化的提升。

提示列表

仓库中未有提示模板相关文档。

资源列表

仓库中未有明确 MCP 资源描述。

工具列表

• loki_query
  用于查询 Grafana Loki 日志数据。
  • 必需参数：
    • query: LogQL 查询字符串
  • 可选参数：
    • url: Loki 服务器地址（默认为 LOKI_URL 环境变量或 http://localhost:3100）
    • start: 查询起始时间（默认：1 小时前）
    • end: 查询结束时间（默认：当前）
    • limit: 返回的最大条数（默认：100）

该 MCP 服务器的应用场景

• 日志数据探索
  开发者或 AI Agent 可编程地查询和分析 Grafana Loki 中的日志数据，辅助故障排查与事件响应。
• 自动化日志监控
  实现基于 LLM 的监控工作流，让 AI 助手能够扫描日志中的异常、错误模式或特定事件。
• 运维仪表盘
  动态获取日志数据，为可视化或报表工具提供所需的数据支撑仪表盘创建。
• 根因分析
  赋能 AI 快速筛查海量日志，通过灵活的 LogQL 查询定位问题根源。

安装与配置

Windsurf

1. 安装 Go 1.16 或更高版本。

2. 构建服务器：
   go build -o loki-mcp-server ./cmd/server

3. 编辑你的 Windsurf 配置文件，添加 MCP 服务器。

4. 以 JSON 片段添加 Loki MCP 服务器（可按需调整）：

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. 保存配置并重启 Windsurf。

6. 验证服务器运行并可访问。

安全设置 API 密钥（环境变量示例）：

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Claude

1. 安装 Go 1.16 或更高版本。

2. 如上所述构建服务器。

3. 打开 Claude 的 MCP 配置文件。

4. 添加 Loki MCP 服务器：

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. 保存并重启 Claude。

6. 确认配置生效。

安全设置 API 密钥：

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cursor

1. 确保已安装 Go 1.16 及以上版本。

2. 构建 Loki MCP 服务器。

3. 编辑 Cursor 的配置文件。

4. 添加 Loki MCP 服务器条目：

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. 保存并重启 Cursor。

6. 验证集成情况。

使用环境变量：

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

Cline

1. 安装 Go >=1.16。

2. 构建：
   go build -o loki-mcp-server ./cmd/server

3. 找到 Cline 的 MCP 服务器配置。

4. 添加 Loki MCP 服务器：

   {
     "mcpServers": {
       "loki-mcp": {
         "command": "./loki-mcp-server",
         "args": []
       }
     }
   }
   

5. 保存并重启 Cline。

6. 测试配置效果。

通过环境变量安全设置 API 密钥：

{
  "mcpServers": {
    "loki-mcp": {
      "command": "./loki-mcp-server",
      "env": {
        "LOKI_URL": "https://your-loki-server.example"
      }
    }
  }
}

如何在流程中使用该 MCP

在 FlowHunt 中集成 MCP

要在 FlowHunt 工作流中集成 MCP 服务器，首先将 MCP 组件添加到流程中，并连接至你的 AI Agent：

点击 MCP 组件打开配置面板。在系统 MCP 配置部分，使用如下 JSON 格式填写你的 MCP 服务器信息：

{
  "loki-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI Agent 即可作为工具使用该 MCP，并访问其全部功能。请记得将 "loki-mcp" 替换为你的 MCP 服务器实际名称，并将 URL 替换为你自己的 MCP 服务器地址。

总览

根据上述表格，Loki MCP 服务器提供了清晰的总览和日志查询工具，但缺少提示模板、资源和高级 MCP 特性（如采样、roots）文档。文档最小化，安装配置面向开发者。

我们的看法

Loki MCP 服务器专注于将 LLM 集成到 Grafana Loki 日志查询中，实用但功能较为精简，缺乏 MCP 的广度特性和完善文档。评分为 4/10：能完成核心用途，但不算功能完备、成熟或高度文档化的 MCP 服务器。

MCP 评分