MCP提交

Grafana Loki MCP

一个基于FastMCP的服务器，支持通过Grafana API查询Loki日志系统，提供标签查询和结果格式化功能。

监控开发者工具 #日志查询 #Grafana #Loki #FastMCP .Python

2.5分

2025-04-28 14:35:23

概述

安装

内容详情

替代品

什么是Grafana-Loki MCP服务器？

Grafana-Loki MCP服务器是一个用于通过Grafana API查询Loki日志的工具。它允许用户轻松获取日志数据，并以多种格式（如文本、JSON、Markdown）展示结果。

如何使用Grafana-Loki MCP服务器？

用户可以通过设置环境变量或直接在命令行中输入参数来启动服务器，并执行日志查询任务。

适用场景

适用于需要高效查询和分析日志数据的企业用户，特别是在监控系统性能和排查问题时。

主要功能

日志查询通过Grafana API支持Loki日志查询，灵活设置时间和方向。

多格式输出支持多种输出格式（如文本、JSON、Markdown），便于用户阅读和处理。

标签管理获取Loki中的标签名称及其值，方便进一步筛选日志数据。

传输协议支持标准输入（stdio）和服务器发送事件（SSE）两种传输协议。

优势与局限性

优势

简单易用，无需复杂配置即可快速上手。

支持多种查询和输出格式，满足多样化需求。

高效的日志查询能力，适合大规模数据分析场景。

开源免费，社区支持活跃。

局限性

需要依赖Python环境运行，可能增加部署成本。

对高并发查询的支持有限，需优化后端性能。

某些高级功能可能需要自定义开发。

如何使用

安装Grafana-Loki MCP服务器通过pip安装服务器，或者克隆代码进行本地开发。

配置环境变量设置Grafana实例URL和API密钥。

启动服务器使用默认设置或指定参数启动服务器。

执行日志查询调用query_loki工具执行具体查询任务。

使用案例

查询错误日志查询过去6小时内包含“error”的日志记录。

格式化查询结果将查询结果转换为Markdown格式，便于报告生成。

常见问题

如何安装Grafana-Loki MCP服务器？可以使用pip安装：pip install grafana-loki-mcp。

是否支持其他输出格式？支持文本、JSON和Markdown等多种格式。

查询结果是否有大小限制？最大结果数量可以通过参数控制，默认为100条。

如何提高查询效率？合理设置查询时间范围和方向，避免过大的时间跨度。

相关资源

官方文档GitHub上的项目主页和详细文档。

快速入门指南帮助新用户快速了解如何开始使用。

社区论坛与开发者和其他用户交流的地方。

精选MCP服务推荐

Figma Context MCP

Framelink Figma MCP Server是一个为AI编程工具（如Cursor）提供Figma设计数据访问的服务器，通过简化Figma API响应，帮助AI更准确地实现设计到代码的一键转换。

Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器，提供丰富的网页抓取、搜索和内容提取功能。

TypeScript

2,984

5分

Duckduckgo MCP Server

已认证

DuckDuckGo搜索MCP服务器，为Claude等LLM提供网页搜索和内容抓取服务

MiniMax Model Context Protocol (MCP) 是一个官方服务器，支持与强大的文本转语音、视频/图像生成API交互，适用于多种客户端工具如Claude Desktop、Cursor等。

百度地图MCP Server是国内首个兼容MCP协议的地图服务，提供地理编码、路线规划等10个标准化API接口，支持Python和Typescript快速接入，赋能智能体实现地图相关功能。

Python

336

4.5分

Edgeone Pages MCP Server

EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务

TypeScript

4.8分

Context7

Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务，通过Model Context Protocol直接集成到提示中，解决LLM使用过时信息的问题。

Exa MCP Server是一个为AI助手（如Claude）提供网络搜索功能的服务器，通过Exa AI搜索API实现实时、安全的网络信息获取。

TypeScript

1,440

5分

Grafana-Loki MCP 服务器

一个 FastMCP 服务器，允许通过 Grafana 查询 Loki 日志。

MCP 服务器配置

{
  "mcpServers": {
    "loki": {
      "command": "uvx",
      "args": [
        "grafana-loki-mcp",
        "-u",
        "GRAFANA_URL",
        "-k",
        "GRAFANA_API_KEY"
      ]
    }
  }
}

GRAFANA_URL: 您的 Grafana 实例 URL
GRAFANA_API_KEY: 具备相应权限的 Grafana API 密钥

功能

查询 Loki 日志
获取日志中的标签和值
格式化查询结果（支持文本、JSON 和 Markdown）
支持两种传输协议：stdio 和 SSE

要求

Python 3.6 或更高版本
必须安装以下依赖项：
- FastMCP
- PyYAML

安装

使用 pip

pip install grafana-loki-mcp

开发环境

克隆仓库：

git clone https://github.com/tumf/grafana-loki-mcp.git
cd grafana-loki-mcp

安装依赖项：
```
pip install -r requirements.txt
```
运行测试：
```
python -m pytest tests/
```

使用方法

环境变量

设置以下环境变量：

export GRAFANA_URL="http://localhost:3000"
export GRAFANA_API_KEY="your_api_key_here"

命令行参数

运行服务器：

grafana-loki-mcp --config config.yaml

示例配置文件 `config.yaml`

mcpServers:
  loki:
    command: uvx
    args:
      - grafana-loki-mcp
      - -u
      - http://localhost:3000
      - -k
      - your_api_key_here

开发

测试

运行测试套件：

pytest tests/ -v

代码规范

使用以下工具确保代码规范：

black 格式化代码
flake8 检查代码错误
mypy 静态类型检查

文档

查看官方文档了解详细信息。

可用工具

查询日志 (`query_loki`)

{
    "query": "{app=\"my-app\"} |= \"error\"",
    "limit": 50,
    "max_per_line": 100,
    "start": "now-6h",
    "end": "now"
}

获取标签 (`get_loki_labels`)

{
    "query": "{__name__}"
}

格式化结果 (`format_loki_results`)

{
    "results": "...",
    "format_type": "markdown",
    "max_per_line": 100
}

示例代码

import asyncio
from pygql import client

async def main():
    # 初始化客户端
    cli = await client("http://localhost:8090")
    
    # 查询日志
    results = await cli.call(
        "query_loki",
        {
            "query": '{app="my-app"} |= "error"',
            "limit": 50,
            "max_per_line": 100,
            "start": "now-6h",
            "end": "now"
        }
    )
    
    # 格式化结果
    formatted = await cli.call(
        "format_loki_results",
        {
            "results": results,
            "format_type": "markdown",
            "max_per_line": 100
        }
    )
    
    print(formatted)

asyncio.run(main())