prometheus-mcp-server

What is prometheus-mcp-server?

A TypeScript-based Model Context Protocol (MCP) server that bridges Claude and Prometheus, enabling querying of metrics, series, labels, alerts, rules, and server status via PromQL.

How to use prometheus-mcp-server?

Install globally with npm install -g prometheus-mcp-server or run via npx prometheus-mcp-server. Configure the Prometheus URL using the PROMETHEUS_BASE_URL environment variable (defaults to http://localhost:9090). Add the server to Claude Desktop’s config file (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json) with the appropriate command and env settings.

Key features of prometheus-mcp-server

• Instant PromQL queries at a specific time
• Range PromQL queries over a time period
• Series discovery by label matchers
• Label name and value exploration
• Metadata access for metrics
• Target information from scrape configurations
• Alerts and recording/alerting rules
• Prometheus server status information

Use cases of prometheus-mcp-server

• Query current metric values for dashboards or alerting checks.
• Retrieve time-series data over a window for analysis or reporting.
• Discover available series and labels to explore the metric schema.
• Inspect scrape targets, alerts, and rules for operational monitoring.
• Get server status to verify Prometheus health and configuration.

FAQ from prometheus-mcp-server

How do I configure the Prometheus server URL?

Set the PROMETHEUS_BASE_URL environment variable to the desired Prometheus HTTP endpoint. The default is http://localhost:9090.

What functions does prometheus-mcp-server expose?

It provides nine MCP functions: mcp__instant_query, mcp__range_query, mcp__get_series, mcp__get_label_values, mcp__get_metadata, mcp__get_targets, mcp__get_alerts, mcp__get_rules, and mcp__get_status.

How can I run prometheus-mcp-server without installing it?

Use npx: npx prometheus-mcp-server. You can also set the PROMETHEUS_BASE_URL environment variable inline when using npx.

What transport does the server use?

It communicates over stdio, as is standard for MCP servers (mentioning stdio in the Debugging section for inspecting and debugging).

Are there any runtime dependencies beyond Node.js?

The server is a TypeScript project that compiles to JavaScript; Node.js is required to run it. All dependencies are bundled via npm.