prometheus-mcp-server

What is prometheus-mcp-server?

A Golang-based Model Context Protocol (MCP) server that enables natural language interactions with Prometheus metrics and queries. It acts as a bridge between MCP-compatible clients (like Claude Desktop) and Prometheus servers, providing full compatibility with the Prometheus HTTP API v1.

How to use prometheus-mcp-server?

Run the server by specifying the Prometheus address and transport. Use Docker, a pre-built binary, or build from source. Example: prometheus-mcp-server --prom-addr="http://localhost:9090" (defaults to stdio transport). Configurable flags: -prom-addr, -transport (stdio, http, sse), -mcp-addr.

Key features of prometheus-mcp-server

• Complete Prometheus API v1 coverage via MCP tools
• Instant and range query execution
• Metadata discovery (series, labels, values)
• Target, rule, and alert management
• TSDB administration (snapshots, series deletion)
• Multiple transport options (HTTP, SSE, stdio)

Use cases of prometheus-mcp-server

• Query Prometheus metrics using natural language from an MCP client
• Monitor alerting rules and targets without writing PromQL directly
• Retrieve historical metric data over defined time ranges
• Perform administrative tasks like TSDB snapshots or series deletion
• Integrate Prometheus observability into AI-powered assistants

FAQ from prometheus-mcp-server

—

What dependencies are required?

Go 1.23+ and a running Prometheus server v2.x, plus a compatible MCP client.

How is data accessed?

All queries go directly against the Prometheus HTTP API; no data is stored locally by the server.

What transport protocols are supported?

stdio (default), HTTP, and SSE (deprecated). HTTP is recommended for web integrations.

Are there any known limitations?

—

How is authentication handled?

—