Loglmhq MCP Server Prometheus

🚀 mcp-server-prometheus

這是一個基於TypeScript的MCP服務器，實現了Prometheus API接口。它藉助模型上下文協議（MCP），為Claude搭建了一座橋樑，使其能夠與您的Prometheus服務器進行交互。

🚀 快速開始

配置

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

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

可選的身份驗證配置：

• PROMETHEUS_USERNAME：基本身份驗證的用戶名（如果需要）
• PROMETHEUS_PASSWORD：基本身份驗證的密碼（如果需要）

安裝

要與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。

✨ 主要特性

資源

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

當前功能

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

📚 詳細文檔

演示

API結構

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

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

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

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