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