MetricFire MCP Server

官方

使用自然语言监控您的基础设施，借助全新的MetricFire模型上下文协议（MCP）服务器。将MetricFire MCP服务器连接到GitHub Copilot等AI助手，通过简单提示即可搜索指标、可视化数据、创建警报并管理监控环境，无需编写API调用。

访问 hostedgraphite.com

你可以用 MetricFire MCP 做什么？

搜索指标 — 让您的助手按模式或标签查找指标，包括繁忙或无效的指标。
渲染 Graphite 数据 — 请求指定时间范围内的指标数据，格式可为 JSON、CSV、原始、PNG 或 SVG。
管理警报 — 创建、更新、搜索、静音或删除警报，包括使用 AND/OR 逻辑的复合警报。
构建 Grafana 仪表板 — 让您的助手根据自然语言提示创建或更新仪表板和面板。
处理通知渠道 — 检索、创建、更新或删除渠道，如电子邮件、Slack、PagerDuty 和 Webhook。
安排静音 — 设置定期静音窗口（例如周末），并将其与警报关联。

文档

有关完整文档索引，请参阅 llms.txt。文档页面的 Markdown 版本可通过在页面 URL 后附加 .md 获得；本页面也可作为 Markdown 使用。

MF MCP Server

通过自然语言提示，将 AI 助手连接到 Hosted Graphite API 并进行交互。

创建 MCP Token

在您的 Hosted Graphite 账户中，导航至 Add-Ons ⇒ MetricFire MCP Server

创建一个 token，并选择您的 MCP 客户端所需的权限：

读取 – 访问指标、渲染、告警、通知渠道、定时静音以及其他受支持的资源。
写入 – 创建或修改受支持的资源。
删除 – 删除受支持的资源。

我们建议仅授予工作流所需的最低权限。

完整的 MCP token 仅在创建时显示一次。请在离开页面之前妥善保存。

连接 MCP 客户端

Hosted Graphite 的 MCP 端点为：

https://mcp.hostedgraphite.com/

不同 MCP 客户端的配置略有差异。

GitHub Copilot (VS Code)

打开 VS Code 命令面板并选择：MCP: Open User Configuration

添加 MetricFire MCP Server 对象：

{
  "servers": {
    "mf-mcp-server": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "YOUR-MCP-TOKEN"
      }
    }
  }
}

保存配置，在 VS Code 中启动 MCP 服务器，然后通过 Copilot Chat 与代理交互。

Cursor、Claude Code、Cline、Windsurf

这些客户端支持自定义 HTTP 请求头。配置端点：

https://mcp.hostedgraphite.com/

并传入您的 token：

X-HostedGraphite-MCP-Token: <MF-MCP-TOKEN>

有关服务器配置的位置和格式，请参阅您所用客户端的 MCP 文档。

Claude

Claude 的浏览器/界面配置可通过在服务器 URL 中使用 MCP token 进行连接：

https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com

注意：使用基于 URL 的身份验证时，我们强烈建议使用只读 token，除非确实需要写入或删除权限。

可用工具

连接后，您的 MCP 客户端可以发现 Hosted Graphite 当前暴露的工具。

指标

可用的工具包括：

标准指标搜索（按模式*）
带标签的指标搜索
繁忙指标
无效指标
指标删除

Graphite 渲染

可通过 MCP 查询 Graphite Render API，支持以下格式：

JSON
CSV
原始数据
PNG
SVG

这使得 MCP 客户端能够定位指标，并在指定时间范围内检索或可视化其数据。

告警

AI 助手可以使用您的 Hosted Graphite 指标构建有意义的复合告警（使用 AND/OR 逻辑），从而更轻松地针对服务级问题而非单个指标阈值进行告警。

例如：“查找我生产服务器上相关的 CPU、内存、磁盘和网络指标，并创建一个复合告警，当多个信号表明存在服务级问题时通过电子邮件通知我。”

告警工具支持：

创建和更新告警
搜索和检索告警
删除告警
静音和取消静音告警
告警状态和历史记录
使用 AND/OR 逻辑的复合告警条件

仪表盘

AI 客户端可以引用您 Hosted Graphite 账户中存储的指标，并通过自然语言提示来构建、更新和管理 Grafana 仪表盘。您无需手动搜索指标、逐个创建面板和配置可视化，只需让 AI 助手围绕您想要监控的服务、主机、应用程序或基础设施组件构建仪表盘即可。

例如：“查找我生产服务器上相关的 CPU、内存、磁盘和网络指标，并构建一个全面的基础设施概览仪表盘。”

仪表盘工具支持：

创建 Grafana 仪表盘
更新现有仪表盘
搜索和检索仪表盘
删除仪表盘
创建和配置仪表盘面板
使用 Hosted Graphite 指标通过自然语言提示构建仪表盘

{% embed url="https://www.youtube.com/watch?v=jzkK_87fi0Q" %}

通知渠道

MCP 客户端可以使用 Hosted Graphite 通知渠道（电子邮件、Slack、PagerDuty、MS Teams、webhooks 等），包括检索渠道并将其与告警关联。根据 token 权限，受支持的渠道也可以被创建、更新或删除。

定时静音

定时静音工具允许 MCP 客户端创建和管理周期性静音窗口（例如周末）。定时静音是独立的资源，可通过 Alert API 与告警关联。

工作原理

MetricFire MCP Server 为受支持的 Hosted Graphite API 提供 MCP 接口。已连接的 AI 客户端会根据请求选择合适的 MCP 工具，并使用与您的 MCP token 关联的权限来执行该工具。

MCP 集成不会取代您现有的指标收集方式。请继续使用现有的代理、集成或受支持的协议将数据发送到 Hosted Graphite。

有关底层 API 的更多详细信息，请参阅 Hosted Graphite API 文档。如果您在连接 MCP 客户端时需要帮助，请通过以下方式联系我们：support@metricfire.com

MCP 目前不适用于已从 Heroku Marketplace 启用 Hosted Graphite Add-on 的用户。请联系我们，了解如何将您的 Heroku HG 账户迁移到专用 HG 账户，并充分利用 MCP 和日志记录等所有可用功能。

代理说明

本文档通过 GitBook 发布。GitBook 是一个文档平台，旨在让人类和 AI 代理都能有效阅读、导航和推理技术内容。了解更多信息，请访问 gitbook.com。

查询本文档

如果您需要本页面未直接提供的额外信息，您可以通过提问来查询文档。

对以下 URL 执行 HTTP GET 请求，并携带 ask 和 goal 查询参数：

GET https://docs.hostedgraphite.com/add-ons-and-integrations-guide/mf-mcp-server.md?ask=<question>&goal=<user_goal>

ask 是直接问题：它应当具体、自包含，并以自然语言书写。 goal 是用户最终想要实现的目标，即他们需要答案的原因。分享目标有助于 GitBook 为您提供更好、更相关的答案。当目标描述的是用户期望的结果而非复述问题时，它最为有用。例如，对于 ask=how do I create an API token，像 automate deployments from our CI pipeline 这样的目标可以让 GitBook 针对该用例定制答案。

响应将包含问题的直接答案以及文档中的相关摘录和来源。

当答案未明确出现在当前页面、您需要澄清或额外上下文，或者您想要检索相关文档章节时，请使用此机制。

MetricFire MCP Server

你可以用 MetricFire MCP 做什么？

文档

MF MCP Server

目录

代理说明

查询本文档