MetricFire MCP Server
官方使用自然語言監控您的基礎設施,透過全新的 MetricFire Model Context Protocol (MCP) Server。將 MetricFire MCP Server 連接到 GitHub Copilot 等 AI 助手,並使用簡單提示來搜尋指標、視覺化資料、建立警示,以及管理您的監控環境,無需撰寫 API 呼叫。
你可以用 MetricFire MCP 做什麼?
- 搜尋指標 — 請您的助理依模式或標籤尋找指標,包括忙碌或無效的指標。
- 呈現 Graphite 資料 — 以 JSON、CSV、原始、PNG 或 SVG 格式請求指定時間範圍內的指標資料。
- 管理警示 — 建立、更新、搜尋、靜音或刪除警示,包括使用 AND/OR 邏輯的複合警示。
- 建置 Grafana 儀表板 — 讓您的助理根據自然語言提示建立或更新儀表板與面板。
- 處理通知管道 — 擷取、建立、更新或刪除如 Email、Slack、PagerDuty 及 webhooks 等管道。
- 排程靜音 — 設定週期性靜音時段(例如週末),並將其與警示關聯。
文件
如需完整的文件索引,請參閱 llms.txt。文件頁面的 Markdown 版本可透過在頁面 URL 後附加
.md取得;本頁面亦可見 Markdown 版本。
MF MCP Server
透過自然語言提示,將 AI 助理連線至 Hosted Graphite API 並與之互動。
目錄
{% embed url="https://www.youtube.com/watch?t=15s&v=7dIbd2rxARs" %}
MetricFire MCP Server 可讓受支援的 AI 用戶端透過 Model Context Protocol (MCP) 直接與您的 Hosted Graphite 帳戶互動。
連線後,GitHub Copilot、Cursor、Claude/Claude Code 等用戶端即可使用 Hosted Graphite API 進行指標探索、Graphite 渲染、警示管理、通知管道、排程靜音及其他監控工作流程。
MCP server 會操作您 Hosted Graphite 帳戶中的資料與資源。指標必須先傳送至 Hosted Graphite 並儲存,之後才能進行搜尋、渲染或用於警示。
建立 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 server,並透過 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 通知管道(Email、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 與 Logging 等所有可用功能。
Agent 指示
本文件使用 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 針對該使用情境調整答案。
回應將包含問題的直接答案,以及文件中的相關摘錄與來源。
當答案未明確出現在目前頁面、您需要釐清或額外脈絡,或您想擷取相關文件章節時,請使用此機制。