Prometheus MCP Server 7t1

🚀 Prometheus MCP 服務器

Prometheus MCP 服務器是一個用於與 Prometheus 指標和數據交互的 Model Context Protocol (MCP) 服務器。它基於 TypeScript 實現了 Prometheus 臺 API 接口，為 Claude 與 Prometheus 服務器之間搭建了一座橋樑，使其能夠通過 MCP 進行交互。

🚀 快速開始

Prometheus MCP 服務器是一個強大的工具，可幫助您與 Prometheus 指標和數據進行交互。以下是使用該服務器的基本步驟：

1. 安裝服務器（具體安裝方法見“📦 安裝指南”）。
2. 配置服務器環境變量（具體配置信息見“📚 詳細文檔”）。
3. 將服務器配置添加到 Claude Desktop 中（具體配置方法見“📚 詳細文檔”）。

✨ 主要特性

• 即時查詢：可執行特定時間點的 PromQL 查詢。
• 範圍查詢：能在一段時間範圍內執行 PromQL 查詢。
• 系列發現：可根據標籤匹配器查找系列數據。
• 標籤探索：能獲取特定標籤的值。
• 元數據訪問：可獲取指標的元數據。
• 目標信息：能獲取抓取目標的信息。
• 警報與規則：可獲取警報和記錄規則的信息。
• 狀態信息：能獲取 Prometheus 服務器的狀態信息。

📦 安裝指南

您可以選擇以下任意一種方式安裝 Prometheus MCP 服務器：

# 全局安裝
npm install -g prometheus-mcp-server

# 或者本地安裝
npm install prometheus-mcp-server

# 或者使用 npx 運行無需安裝
npx prometheus-mcp-server

💻 使用示例

與 Claude 一起使用

要在 Claude Desktop 中使用，請添加服務器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "/path/to/prometheus-mcp-server/build/index.js",
      "env": {
        "PROMETHEUS_HOST": "http://your-prometheus-instance:9090"
      }
    }
  }
}

使用 npx

您也可以在 Claude Desktop 配置中使用 npx：

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "npx prometheus-mcp-server",
      "env": {
        "PROMETHEUS_HOST": "http://your-prometheus-instance:9090"
      }
    }
  }
}

📚 詳細文檔

配置

服務器需要以下環境變量：

• PROMETHEUS_HOST：您的 Prometheus 實例的基礎 URL（默認值為 http://localhost:9090）

可用函數

服務器提供了以下函數：

• mcp__instant_query：執行即時 PromQL 查詢
• mcp__range_query：在一段時間範圍內執行 PromQL 查詢
• mcp__get_series：根據標籤匹配器查找系列數據
• mcp__get_label_values：獲取特定標籤的值
• mcp__get_metadata：獲取指標的元數據
• mcp__get_targets：獲取抓取目標的信息
• mcp__get_alerts：獲取警報信息
• mcp__get_rules：獲取記錄和警報規則的信息
• mcp__get_status：獲取 Prometheus 服務器的狀態信息

🔧 技術細節

開發

# 安裝依賴項
npm install

# 構建項目
npm run build

# 啟動服務器
npm start

# 調試
npm run dev:debug

調試

由於 MCP 服務器通過 stdio 進行通信，調試可能會比較困難。您可以使用以下 npm 腳本來進行調試：

# 檢查模式
npm run inspect

# 帶斷點檢查
npm run inspect-debug

📄 許可證

本項目採用 ISC 許可證。

🌟 貢獻

歡迎貢獻！請隨意提交 Pull Request。