Hosted Graphite MCP Server

什么是 Hosted Graphite MCP Server？

Hosted Graphite MCP Server 是 MetricFire 官方托管的端点（https://mcp.hostedgraphite.com/），让 AI 助手可以搜索和渲染你在 Hosted Graphite 中的指标，并管理告警、静默、通知渠道和 Grafana 仪表盘。它使用 MCP 令牌进行认证。

Hosted Graphite 是 MetricFire 的托管监控服务，指标基于 Graphite，仪表盘基于 Grafana。MetricFire 文档称其为 MetricFire MCP Server。它面向已经把指标发送到 Hosted Graphite 的 SRE、DevOps 工程师和开发者，让 Claude、Cursor 或 GitHub Copilot 等助手根据自然语言请求排查指标、调整告警并构建仪表盘。

如何使用 Hosted Graphite MCP Server？

你的指标必须已经转发到 Hosted Graphite；MCP 服务器不会取代你现有的采集方式。然后创建令牌：

1. 在 Hosted Graphite 账户中，进入 Add-Ons ⇒ MetricFire MCP Server。
2. 选择令牌所需的权限：Read、Write 和/或 Delete。MetricFire 建议只授予工作流所需的最小权限。
3. 立即复制令牌；完整的值只显示一次。

大多数客户端通过请求头发送令牌：

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

Claude Code

claude mcp add --transport http hosted-graphite https://mcp.hostedgraphite.com/ \
  --header "X-HostedGraphite-MCP-Token: $HOSTEDGRAPHITE_MCP_TOKEN"

Claude Desktop 与 claude.ai

对于 Claude 的浏览器和应用界面，MetricFire 文档给出了一种嵌入令牌的 URL，格式为 https://<MF-MCP-TOKEN>@mcp.hostedgraphite.com，作为自定义连接器 URL 填写（Settings → Connectors → Add custom connector）。MetricFire 建议这种方式使用只读令牌，除非你需要写入或删除权限。

Cursor

{
  "mcpServers": {
    "hosted-graphite": {
      "url": "https://mcp.hostedgraphite.com/",
      "headers": {
        "X-HostedGraphite-MCP-Token": "<MF-MCP-TOKEN>"
      }
    }
  }
}

VS Code（GitHub Copilot）

从命令面板运行 MCP: Open User Configuration，并按 MetricFire 文档添加：

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

保存后在 VS Code 中启动该服务器，然后使用 Copilot Chat。

Hosted Graphite MCP Server 的主要功能

• MetricFire 为 Hosted Graphite 账户提供的官方服务器。
• 按 Graphite 风格的模式和标签表达式发现指标，并提供繁忙指标和无效指标报告。
• Graphite 渲染查询，可按所选时间范围返回数据或图表图片。
• 完整的告警管理，包括组合告警、静默、定时静默和告警历史。
• 支持电子邮件、Slack、PagerDuty、Webhook、VictorOps 和 Opsgenie 的通知渠道。
• 创建和编辑 Grafana 仪表盘，包括根据自然语言提示生成仪表盘。
• 令牌权限分为 Read、Write 和 Delete，便于限制智能体可以修改的内容。

Hosted Graphite MCP Server 工具

服务器提供 35 个工具，分为六组：

• 指标：metric_search 按模式查找指标（例如 foo.bar.*），busy_metrics 返回最繁忙的指标及其速率限制百分比，invalid_metrics 列出被解析器拒绝的指标，delete_metrics 删除匹配的指标。
• 标签：list_tags、search_tag_values、find_tagged_series 和 delete_tagged_series 用于处理带标签的序列。
• 渲染：render_graphite 查询 Graphite 渲染 API，获取指标数据或图表图片。
• 告警：create_alert、search_alerts、get_alert、update_alert、delete_alert、mute_alert、unmute_alert、批量的 mute_alerts 和 unmute_alerts、get_alert_mute_status 以及 get_alert_history。
• 通知渠道与定时静默：两者各有创建、搜索、获取、更新和删除工具，例如 create_notification_channel 和 create_scheduled_mute。
• 仪表盘：create_dashboard、list_dashboards、get_dashboard、update_dashboard 和 delete_dashboard，用于 Grafana。

Hosted Graphite MCP Server 的使用场景

• 故障排查：「显示 checkout 服务过去六小时的错误率指标。」
• 告警调优：「当 api.latency.p95 连续 5 分钟高于 500 ms 时创建告警，并发送到我们的 Slack 频道。」
• 维护窗口：「为所有数据库告警设置每周日 02:00 到 04:00 的定时静默。」
• 构建仪表盘：「为 prod 主机构建一个包含 CPU、内存和磁盘面板的 Grafana 仪表盘。」
• 清理：「列出无效指标和最繁忙的指标，方便我修复产生噪声的发送方。」

Hosted Graphite MCP Server 常见问题排查

• 找不到指标：指标必须先存储在 Hosted Graphite 中，才能被搜索、渲染或用于告警。
• 创建或删除时出现权限错误：令牌创建时没有 Write 或 Delete 权限。请创建一个具有所需权限的新令牌。
• 令牌丢失：完整令牌只显示一次。请在 Add-Ons ⇒ MetricFire MCP Server 中重新生成。
• Heroku 用户无法启用：通过 Heroku Marketplace 插件创建的账户无法使用 MCP 服务器。MetricFire 建议联系他们迁移到独立账户。