Loki MCP 服务器

AI MCP Log Analysis Grafana

联系我们在FlowHunt托管您的MCP服务器

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

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

提示列表

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

FlowHunt 标志

准备好发展您的业务了吗?

今天开始免费试用,几天内即可看到结果。

资源列表

仓库中未有明确 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:

FlowHunt MCP flow

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

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

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


总览

部分可用性备注说明
总览在 README.md 提供了摘要
提示列表未有提示模板文档
资源列表未列出明确的 MCP 资源
工具列表loki_query 工具在 README.md 有说明
安全设置 API 密钥使用 LOKI_URL 环境变量
采样支持(评估中不重要)未有采样支持相关说明

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

我们的看法

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

MCP 评分

是否有 LICENSE
是否有至少一个工具
Fork 数量1
Star 数量5

常见问题

开始使用 Loki MCP 服务器

打通 AI 与日志数据的桥梁。部署 Loki MCP 服务器,为你的 FlowHunt 工作流提供高级日志分析和监控能力。