简单 Loki MCP 服务器

“简单 Loki” MCP 服务器的作用

简单 Loki MCP 服务器是一个模型上下文协议（MCP）接口，使 AI 助手能够直接从 Grafana Loki 实例查询和分析日志。通过使用 logcli 等工具或回退到 Loki HTTP API，该服务器可将日志数据无缝集成到开发工作流中。它支持完整的 LogQL 查询、标签值获取，并以多种输出方式（默认、原始、JSON 行）提供格式化结果。凭借灵活的认证与环境变量或配置文件的配置方式，简单 Loki MCP 服务器非常适合增强 AI 应用或自动化流程中的可观测性、故障排查与监控任务。

提示模板列表

仓库或文档中未提及显式的提示模板。

资源列表

仓库或文档中未列出显式的 MCP 资源。

工具列表

• query-loki
  从 Loki 查询日志并支持过滤选项。该工具允许用户提交 LogQL 查询并检索日志条目，支持多种输出格式及标签元数据访问。

本 MCP 服务器的应用场景

• 日志分析与故障排查
  开发者可使用简单 Loki MCP 服务器分析和筛选 Grafana Loki 的日志数据，更易调试应用与排查问题。
• 自动化事件响应
  AI 助手可在事件处理中自动抓取和总结相关日志，提升响应速度和准确性。
• 可观测性看板
  将日志查询能力集成到自定义看板，实现开发或监控工具的实时日志洞察。
• 安全监控
  利用 AI 代理监控日志中的可疑模式或行为，检测异常时触发告警或自动化操作。
• 性能优化
  分析历史日志数据，识别影响系统性能的瓶颈、错误或趋势，助力主动优化。

如何进行设置

Windsurf

1. 确保已安装 Node.js v16+。
2. 编辑您的 Windsurf 配置文件（如 settings.json）。
3. 在 mcpServers 部分添加简单 Loki MCP 服务器：

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. 保存并重启 Windsurf。
5. 检查日志查询功能以验证服务器是否运行。

Claude

1. 安装 Node.js v16+。
2. 使用 Smithery 安装服务器：

   npx -y @smithery/cli install @ghrud92/simple-loki-mcp --client claude
   

3. 按如下方式添加/更新 Claude 配置：

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. 保存并重启 Claude。
5. 确认 Loki 日志查询可用。

Cursor

1. 确认已安装 Node.js v16+。
2. 打开 Cursor 的配置文件。
3. 在 mcpServers 下插入如下内容：

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. 保存更改并重启 Cursor。
5. 测试日志查询功能。

Cline

1. 确保可用 Node.js v16+。
2. 找到并打开 Cline 的配置文件。
3. 添加简单 Loki MCP 条目：

   {
     "mcpServers": {
       "simple-loki": {
         "command": "npx",
         "args": ["-y", "simple-loki-mcp"],
         "env": {
           "LOKI_ADDR": "https://loki.sup.band"
         }
       }
     }
   }
   

4. 保存并重启 Cline。
5. 检查日志查询集成是否成功。

API 密钥安全

为安全起见，请将敏感凭证（如 LOKI_ADDR 或 token）存储在环境变量中。例如：

{
  "mcpServers": {
    "simple-loki": {
      "command": "npx",
      "args": ["-y", "simple-loki-mcp"],
      "env": {
        "LOKI_ADDR": "${LOKI_ADDR_ENV}",
        "LOKI_TOKEN": "${LOKI_TOKEN_ENV}"
      },
      "inputs": {
        "query": "${YOUR_LOGQL_QUERY}"
      }
    }
  }
}

如何在流程中使用本 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成到您的 FlowHunt 工作流中，请先在流程中添加 MCP 组件并将其连接到您的 AI 代理：

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

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

配置完成后，AI 代理便可将该 MCP 作为工具，使用其全部功能。请注意将 “simple-loki” 替换为实际的 MCP 服务器名称，并将 URL 替换为您自己的 MCP 服务器地址。

总览

综合上述表格，简单 Loki MCP 服务器专注且实用，但在提示和资源支持方面较为欠缺。其设置简便，集成及 API 密钥安全文档清晰。整体而言，非常适合日志查询，但在高级 MCP 能力方面有限。

MCP 评分

评分：
我会给这个 MCP 服务器 6/10。它在自身定位上表现扎实，易于集成，但缺乏多工具、提示模板与明确的资源定义，这些对于更广泛的 MCP 场景至关重要。此外未涉及 Roots 或采样支持。