Prometheus MCP Server

Prometheus MCP Server

[GitHub Container Registry] [Helm Chart] [GitHub Release] [Codecov] [Python] [License]

Give AI assistants the power to query your Prometheus metrics.

A Model Context Protocol (MCP) server that provides access to your Prometheus metrics and queries through standardized MCP interfaces, allowing AI assistants to execute PromQL queries and analyze your metrics data.

Getting Started

Prerequisites

• Prometheus server accessible from your environment
• MCP-compatible client (Claude Desktop, VS Code, Cursor, Windsurf, etc.)

Installation Methods

{  "mcpServers": {    "prometheus": {      "command": "docker",      "args": [        "run",        "-i",        "--rm",        "-e",        "PROMETHEUS_URL",        "ghcr.io/pab1it0/prometheus-mcp-server:latest"      ],      "env": {        "PROMETHEUS_URL": "<your-prometheus-url>"      }    }  }}

claude mcp add prometheus --env PROMETHEUS_URL=http://your-prometheus:9090 -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server:latest

{  "prometheus": {    "command": "docker",    "args": [      "run",      "-i",      "--rm",      "-e",      "PROMETHEUS_URL",      "ghcr.io/pab1it0/prometheus-mcp-server:latest"    ],    "env": {      "PROMETHEUS_URL": "<your-prometheus-url>"    }  }}

# With environment variablesdocker run -i --rm \  -e PROMETHEUS_URL="http://your-prometheus:9090" \  ghcr.io/pab1it0/prometheus-mcp-server:latest
# With authenticationdocker run -i --rm \  -e PROMETHEUS_URL="http://your-prometheus:9090" \  -e PROMETHEUS_USERNAME="admin" \  -e PROMETHEUS_PASSWORD="password" \  ghcr.io/pab1it0/prometheus-mcp-server:latest

helm install prometheus-mcp-server \  oci://ghcr.io/pab1it0/charts/prometheus-mcp-server \  --version 1.1.1 \  --set prometheus.url="http://prometheus:9090"

helm install prometheus-mcp-server \  oci://ghcr.io/pab1it0/charts/prometheus-mcp-server \  --version 1.1.1 \  --set prometheus.url="http://prometheus:9090" \  --set auth.username="admin" \  --set auth.password="secret"

helm install prometheus-mcp-server \  oci://ghcr.io/pab1it0/charts/prometheus-mcp-server \  --version 1.1.1 \  -f values.yaml

Configuration Options

Available Tools

The list of tools is configurable, so you can choose which tools you want to make available to the MCP client. This is useful if you don't use certain functionality or if you don't want to take up too much of the context window.

Features

• Execute PromQL queries against Prometheus
• Discover and explore metrics
  • List available metrics
  • Get metadata for specific metrics
  • Search metric metadata by name or description in a single call
  • View instant query results
  • View range query results with different step intervals
  • Open range query results in the Prometheus UI with the same time window and resolution
• Authentication support
  • Basic auth from environment variables
  • Bearer token auth from environment variables
• Docker containerization support
• Provide interactive tools for AI assistants

Development

Contributions are welcome! Please see our Contributing Guide for detailed information on how to get started, coding standards, and the pull request process.

This project uses uv to manage dependencies. Install uv following the instructions for your platform:

curl -LsSf https://astral.sh/uv/install.sh | sh

You can then create a virtual environment and install the dependencies with:

uv venvsource .venv/bin/activate  # On Unix/macOS.venv\Scripts\activate     # On Windowsuv pip install -e .

Testing

The project includes a comprehensive test suite that ensures functionality and helps prevent regressions.

Run the tests with pytest:

# Install development dependenciesuv pip install -e ".[dev]"
# Run the testspytest
# Run with coverage reportpytest --cov=src --cov-report=term-missing

When adding new features, please also add corresponding tests.

License

MIT