prometheus-mcp-server

Overview

This MCP server provides AI assistants with access to Prometheus metrics data through PromQL queries. It supports both instant and range queries, metric discovery, and metadata retrieval. The server offers multiple authentication methods including basic auth and bearer tokens, making it suitable for enterprise environments. It can be deployed via Docker, Kubernetes (Helm), or as a standalone application.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• health_check

  Health check endpoint for container monitoring and status verification

  Try:Check if the Prometheus server is healthyTry:Verify the MCP server status
• execute_query

  Execute a PromQL instant query against Prometheus

  Try:Get current CPU usage across all nodesTry:Query memory utilization for the last 5 minutes
• execute_range_query

  Execute a PromQL range query with start time, end time, and step interval

  Try:Get request rates for the past hourTry:Calculate average response time over the last day
• list_metrics

  List all available metrics in Prometheus with pagination and filtering support

  Try:Show all available metricsTry:List metrics containing 'http' in their name
• get_metric_metadata

  Get metadata for one metric or bulk metadata with optional filtering

  Try:Get metadata for cpu_usage metricTry:Find metrics related to database performance
• get_targets

  Get information about all scrape targets

  Try:Show all Prometheus targets and their statusTry:List targets that are currently down

Comparable tools

Installation

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

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

FAQ

What authentication methods are supported?

The server supports basic authentication with username/password, bearer token authentication, and mutual TLS authentication with client certificates.

Can I run multiple instances targeting different Prometheus servers?

Yes, you can use the TOOL_PREFIX configuration to run multiple instances with different prefixes, allowing you to target different environments.

Compare prometheus-mcp-server with