MCP Server Prometheus

🚀 mcp-server-prometheus

mcp-server-prometheus是一個與Prometheus指標和數據交互的MCP服務器。它基於TypeScript構建，實現了Prometheus API接口，通過模型上下文協議（MCP）在Claude和Prometheus服務器之間搭建了橋樑。

🚀 快速開始

mcp-server-prometheus是一個強大的工具，它能讓Claude與Prometheus服務器實現交互。下面將為你介紹它的使用步驟。

✨ 主要特性

資源

• 可列出並訪問Prometheus指標模式。
• 每個指標資源提供以下信息：
  • 指標名稱和描述。
  • 來自Prometheus的詳細元數據。
  • 統計信息（計數、最小值、最大值）。
• 支持JSON MIME類型，方便獲取結構化數據。

當前功能

• 列出所有可用的Prometheus指標及其描述。
• 讀取詳細的指標信息，包括：
  • 元數據和幫助文本。
  • 當前統計數據（計數值、最小值、最大值）。
• 支持基本身份驗證，可用於受保護的Prometheus實例。

📦 安裝指南

環境變量配置

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

• PROMETHEUS_URL：您的Prometheus實例的基礎URL。

可選的身份驗證配置：

• PROMETHEUS_USERNAME：基本認證的用戶名（如果需要）。
• PROMETHEUS_PASSWORD：基本認證的密碼（如果需要）。

與Claude Desktop集成

要與Claude Desktop一起使用，請添加服務器配置：

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

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

依賴安裝與構建

安裝依賴項：

npm install

構建服務器：

npm run build

使用自動重建進行開發：

npm run watch

調試

由於MCP服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們建議使用MCP Inspector：

npm run inspector

Inspector將提供一個在瀏覽器中訪問調試工具的URL。

💻 使用示例

基礎用法

以下是使用該服務器的基本步驟：

1. 配置好環境變量。
2. 安裝依賴並構建服務器。
3. 按照上述配置與Claude Desktop集成。

高級用法

如果需要對受保護的Prometheus實例進行操作，可配置PROMETHEUS_USERNAME和PROMETHEUS_PASSWORD進行基本身份驗證。

📚 詳細文檔

演示

API結構

服務器通過以下URI結構公開Prometheus指標：

• 基礎URI：http://your-prometheus-instance:9090
• 指標URI：http://your-prometheus-instance:9090/metrics/{metric_name}

每個指標資源返回包含以下內容的JSON數據：

• 指標名稱
• 元數據（幫助文本、類型）
• 當前統計信息（計數、最小值、最大值）