MCP Prometheus

🚀 Prometheus MCP Server (Go)

Prometheus MCP Server (Go) 是一個用於與 Prometheus 集成的 模型上下文協議 (MCP) 服務器。它是原生的 Go 二進制文件，通過 client-go 實現了內置的 Kubernetes 連接功能。

🚀 快速開始

你可以按照以下不同方式安裝 Prometheus MCP Server (Go)：

📦 安裝指南

npx 安裝

npx -y mcp-prometheus@latest

MCP 客戶端配置

將以下內容添加到你的 MCP 客戶端配置（如 VS Code、Cursor、Windsurf 等）中：

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["-y", "mcp-prometheus@latest"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

VS Code 配置

code --add-mcp '{"name":"prometheus","command":"npx","args":["-y","mcp-prometheus@latest"],"env":{"PROMETHEUS_URL":"http://localhost:9090"}}'

Kubernetes 自動連接

該服務器可通過 K8S API 服務代理自動連接到在 OpenShift/Kubernetes 中運行的 Prometheus。它通過 client-go 使用原生的 kubeconfig/集群內配置，無需 kubectl 或端口轉發。 默認連接地址：openshift-monitoring/prometheus-operated:9090

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["-y", "mcp-prometheus@latest"]
    }
  }
}

二進制安裝

你可以從 GitHub Releases 下載二進制文件，或者從源代碼進行構建：

make build
./mcp-prometheus

📚 詳細文檔

配置

環境變量

CLI 標誌

優先級：--url / PROMETHEUS_URL > K8S 自動連接

連接策略：

1. 直接 URL（如果設置了 --url 或 PROMETHEUS_URL）
2. K8S API 代理（自動檢測 kubeconfig 或集群內配置）

工具 (11)

基本查詢

集群診斷

資源分析

示例提示

"What's the current CPU usage across all nodes?"
"Show me the cluster health overview"
"Which pods are using the most memory?"
"Diagnose node worker-1"
"Are all scrape targets healthy?"
"Compare CPU usage now vs 24 hours ago"
"Investigate pod my-app in namespace production"
"What alerting rules are defined?"

開發

構建

make build              # 為當前平臺構建
make build-all-platforms # 為所有平臺進行交叉編譯

容器構建

podman build -f Containerfile -t mcp-prometheus .

Kubernetes / OpenShift 部署

容器鏡像

容器鏡像可在 GitHub Container Registry 上獲取：

ghcr.io/jeanlopezxyz/mcp-prometheus:latest

Helm 圖表部署

使用包含的 Helm 圖表進行部署：

# 添加圖表倉庫（或使用本地圖表）
helm upgrade --install mcp-prometheus ./charts/mcp-prometheus \
  --namespace mcp-servers \
  --create-namespace \
  --set openshift=true

Helm 值

自定義 Prometheus 示例

helm upgrade --install mcp-prometheus ./charts/mcp-prometheus \
  --namespace mcp-servers \
  --set openshift=true \
  --set prometheus.url=http://prometheus.monitoring:9090

📄 許可證

MIT