mcp-prometheus

Prometheus MCP 服务（Go）

用于集成 Prometheus 的 Model Context Protocol (MCP) 服务。原生 Go 二进制程序，通过 client-go 内置 Kubernetes 连接能力。

安装

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

---

配置

环境变量

变量	描述
PROMETHEUS_URL	直接指定的 Prometheus API URL（优先于 K8S 自动连接）

CLI 标志

标志	描述	默认值
--url	直接指定的 Prometheus URL	-
--namespace	Kubernetes 命名空间	openshift-monitoring
--service	Kubernetes 服务名称	prometheus-operated
--service-port	Kubernetes 服务端口	9090
--service-scheme	服务协议（http/https）	https
--kubeconfig	kubeconfig 文件路径	自动检测

优先级： --url / PROMETHEUS_URL > K8S 自动连接

连接策略：

1. 直接 URL（设置了 --url 或 PROMETHEUS_URL 时）
2. K8S API 代理（自动检测 kubeconfig 或集群内配置）

---

工具（11 个）

基本查询

工具	描述
query	执行 PromQL 即时查询
queryRange	执行 PromQL 时间范围查询
getTargets	获取抓取目标状态
getRules	获取告警规则和记录规则
getPrometheusStatus	获取服务版本和运行时信息

集群诊断

工具	描述
getClusterHealthOverview	全面概览集群健康状况
diagnoseNode	诊断指定节点的健康状况
diagnoseNamespace	诊断命名空间的健康状况

资源分析

工具	描述
getTopResourceConsumers	查看 CPU、内存和网络资源消耗排名
investigatePod	深入调查指定 Pod
compareTimeRanges	比较两个时间段的指标

---

示例提示词

"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              # Build for current platform
make build-all-platforms # Cross-compile for all platforms

容器

podman build -f Containerfile -t mcp-prometheus .

---

Kubernetes / OpenShift 部署

容器镜像

容器镜像可从 GitHub Container Registry 获取：

ghcr.io/jeanlopezxyz/mcp-prometheus:latest

Helm Chart

使用随附的 Helm Chart 部署：

# Add the chart repository (or use local chart)
helm upgrade --install mcp-prometheus ./charts/mcp-prometheus \
  --namespace mcp-servers \
  --create-namespace \
  --set openshift=true

Helm Values

参数	描述	默认值
image.registry	容器注册表	ghcr.io
image.repository	镜像仓库	jeanlopezxyz/mcp-prometheus
image.version	镜像标签	latest
openshift	启用 OpenShift Routes	false
service.port	服务端口	8080
prometheus.namespace	Prometheus 命名空间	openshift-monitoring
prometheus.service	Prometheus 服务名称	prometheus-operated
rbac.useClusterReader	使用 cluster-reader 角色	true

使用自定义 Prometheus 的示例

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

---

许可证

MIT