prometheus-mcp-server logo

prometheus-mcp-server

by weetime

A Model Context Protocol (MCP) server for interacting with Prometheus metrics and data. It provides a bridge between Claude and your Prometheus server through the Model Context Protocol (MCP).

View on GitHub

Last updated: N/A

What is prometheus-mcp-server?

A TypeScript-based MCP server that implements a Prometheus API interface, enabling interaction with Prometheus data through the Model Context Protocol (MCP).

How to use prometheus-mcp-server?

Install the server using npm (globally or locally) or run it with npx. Configure Claude Desktop to use the server by adding it to the mcpServers configuration, specifying the command and setting the PROMETHEUS_HOST environment variable to point to your Prometheus instance.

Key features of prometheus-mcp-server

  • Instant Queries: Execute PromQL queries at a specific time

  • Range Queries: Execute PromQL queries over a time period

  • Series Discovery: Find series by label matchers

  • Label Exploration: Get label names and values

  • Metadata Access: Get metadata for metrics

  • Target Information: Get information about scrape targets

  • Alerts & Rules: Get information about alerts and recording rules

  • Status Information: Get Prometheus server status information

Use cases of prometheus-mcp-server

  • Integrating Prometheus metrics into Claude workflows.

  • Querying Prometheus data directly from Claude.

  • Using Claude to analyze and visualize Prometheus metrics.

  • Automating tasks based on Prometheus alerts and rules.

FAQ from prometheus-mcp-server

What is the default Prometheus host?

The default Prometheus host is http://localhost:9090.

How do I configure the Prometheus host?

Set the PROMETHEUS_HOST environment variable to the base URL of your Prometheus instance.

How do I install the server?

You can install it globally or locally using npm, or run it directly with npx.

How do I debug the server?

Use the provided npm scripts for inspect mode or inspect with breakpoints.

What functions are available?

The server provides functions for instant queries, range queries, series discovery, label exploration, metadata access, target information, alerts, rules, and status information.