Grafana MCP 服务器项目使用教程

Grafana MCP 服务器项目使用教程

mcp-grafana MCP server for Grafana 项目地址: https://gitcode.com/gh_mirrors/mc/mcp-grafana

1. 项目介绍

Grafana MCP（Model Context Protocol）服务器项目是一个开源项目，为Grafana提供了一个MCP服务器。它能够提供对Grafana实例及其周边生态系统的访问，支持搜索仪表板、获取数据源信息、查询Prometheus和Loki数据等功能。该项目适用于需要通过编程方式与Grafana交互的场景。

2. 项目快速启动

环境准备

• Go语言环境
• Docker（可选，用于运行集成测试）

从源码构建

git clone https://github.com/grafana/mcp-grafana.git
cd mcp-grafana
make build

构建完成后，将在cmd/mcp-grafana目录下生成可执行文件。

运行服务器

运行以下命令启动MCP服务器：

./mcp-grafana

配置客户端

在客户端配置文件中添加服务器配置。以下是一个使用Claude Desktop配置的示例：

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": [],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_API_KEY": "<你的服务账户令牌>"
      }
    }
  }
}

将<你的服务账户令牌>替换为你的Grafana服务账户令牌。

启用调试模式

如果需要启用调试模式以进行故障排除，可以在命令中添加-debug标志：

./mcp-grafana -debug

客户端配置也需要相应调整以包含-debug参数。

3. 应用案例和最佳实践

搜索仪表板

通过MCP服务器，可以搜索Grafana中的仪表板：

// 伪代码示例
client.SearchDashboards("关键词")

查询Prometheus数据

执行Prometheus数据源的查询：

// 伪代码示例
client.QueryPrometheus("PromQL表达式")

创建和管理警报规则

列出、获取、创建和更改Grafana中的警报规则：

// 伪代码示例
client.ListAlertRules()
client.GetAlertRuleByUID("规则UID")
client.CreateAlertRule("规则详情")
client.ChangeAlertRule("规则UID", "新的规则详情")

4. 典型生态项目

Grafana生态系统中包含了多个与MCP服务器相互配合使用的项目，以下是一些典型的例子：

• Grafana Loki：一个日志聚合系统，与MCP服务器配合可用于日志查询和分析。
• Grafana Tempo：一个分布式追踪系统，可以与MCP服务器一起使用来分析应用程序性能。
• Grafana Cloud：Grafana的云服务，提供了监控、日志和告警的全面解决方案，可以通过MCP服务器进行集成。

通过使用这些生态项目，可以进一步扩展Grafana MCP服务器的功能和应用场景。

mcp-grafana MCP server for Grafana 项目地址: https://gitcode.com/gh_mirrors/mc/mcp-grafana