本地 Loki MCP 服务器

一个用于本地 Grafana Loki 实例的小型只读 MCP 服务器。它使用 FastAPI 和官方 MCP Python SDK 构建。

它提供的内容

• search_logs(service, start, end, text=None) — 在必需的 RFC 3339 时间范围内搜索必需的服务和可选的文字文本。

• list_services(start, end) — 列出可用的服务标签值。

• loki_health() — 检查 Loki 是否就绪。

公共工具没有 limit 参数。请求也省略了 Loki 的 limit 查询参数，因此应用 Loki 自身配置的默认值/最大值。

Related MCP server: grafana-mcp

运行

1. 安装 Python 3.11 或更高版本，然后创建并激活虚拟环境。

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. 如果默认值不符合你的设置，请在 shell 中设置环境变量。.env.example 列出了可用的设置。默认值期望 Loki 位于 http://127.0.0.1:3100，并使用 service_name 标签。

3. 启动服务器。

uvicorn main:app --reload

MCP Streamable HTTP 端点是 http://127.0.0.1:8000/mcp。服务器自身的健康检查端点是 http://127.0.0.1:8000/health。

示例

使用以下参数调用 search_logs：

{
  "service": "checkout",
  "text": "connection refused",
  "start": "2026-08-26T08:00:00Z",
  "end": "2026-08-26T09:00:00Z"
}

会生成以下 LogQL 查询：

{service_name="checkout"} |= "connection refused"

如果你的标签改用 app，请使用 $env:LOKI_SERVICE_LABEL = "app" 启动服务器。