jeanlopezxyz avatar

Mcp Prometheus

jeanlopezxyz/mcp-prometheus

Connects Claude to Prometheus monitoring through 11 tools spanning instant queries, range queries, and cluster diagnostics. Built in Go with native Kubernetes integration via client-go, so it can automatically proxy through the K8s API to reach Prometheus without port-forwarding. You get the standard PromQL operations plus higher-level tools like getClusterHealthOverview, diagnoseNode, and getTopResourceConsumers that bundle common observability patterns. Works with direct Prometheus URLs or auto-detects OpenShift monitoring setups. Reach for this when you want Claude to query metrics, investigate pod issues, or compare performance across time windows without leaving the conversation.

tools
11
transport
STDIO
last updated
Feb 3, 2026

Tools

11 tools

Public tool metadata for what this MCP can expose to an agent.

queryExecute a PromQL instant query

Execute a PromQL instant query

No parameter schema in public metadata yet.

queryRangeExecute a PromQL range query over time

Execute a PromQL range query over time

No parameter schema in public metadata yet.

getTargetsGet scrape targets status

Get scrape targets status

No parameter schema in public metadata yet.

getRulesGet alerting and recording rules

Get alerting and recording rules

No parameter schema in public metadata yet.

getPrometheusStatusGet server version and runtime info

Get server version and runtime info

No parameter schema in public metadata yet.

getClusterHealthOverviewComprehensive cluster health overview

Comprehensive cluster health overview

No parameter schema in public metadata yet.

diagnoseNodeDiagnose a specific node's health

Diagnose a specific node's health

No parameter schema in public metadata yet.

diagnoseNamespaceDiagnose a namespace's health

Diagnose a namespace's health

No parameter schema in public metadata yet.

getTopResourceConsumersTop CPU/memory/network consumers

Top CPU/memory/network consumers

No parameter schema in public metadata yet.

investigatePodDeep investigation of a specific pod

Deep investigation of a specific pod

No parameter schema in public metadata yet.

compareTimeRangesCompare metrics between two time periods

Compare metrics between two time periods

No parameter schema in public metadata yet.

Sponsors

Readme

Prometheus MCP Server (Go)

License: MIT npm version Go GitHub release

A Model Context Protocol (MCP) server for Prometheus integration. Native Go binary with built-in Kubernetes connectivity via client-go.

Installation

npx

npx -y mcp-prometheus@latest

MCP Client Configuration

Add to your MCP client configuration (VS Code, Cursor, Windsurf, etc.):

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

VS Code


View the full README on GitHub

Details

Repository
github.com/jeanlopezxyz/mcp-prometheus
Category
Monitoring & Observability
Package
mcp-prometheus
Transport
STDIO
Registry
MCP registry, active

More from jeanlopezxyz

Related Monitoring & Observability MCP servers

View all
1builderio avatarAgent-Native Analyticsbuilderio/agent-nativeAgent-Native Amplitude/Mixpanel - connect data sources, prompt for charts7.6Kstars
2googleanalytics avatarAnalyticsgoogleanalytics/google-analytics-mcpProvides access to Google Analytics data and reports via an MCP API surface.2.1Kstars
3getsentry avatarSentrygetsentry/toolkitMCP server for Sentry - error monitoring, issue tracking, and debugging for AI assistants0stars
4pab1it0 avatarPrometheus MCP Serverpab1it0/prometheus-mcp-serverMCP server providing Prometheus metrics access and PromQL query execution for AI assistants522stars
5surendranb avatarGoogle Analytics Mcpsurendranb/google-analytics-mcpGA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.244stars
6nikolai-vysotskyi avatarTrace Mcpnikolai-vysotskyi/trace-mcpCode graph MCP: 81 languages, 91 frameworks, 72.7% fewer PR-review tokens, comprehension at parity203stars