Prometheus MCP Server

@shaxiaozz

Basic information

About Prometheus MCP Server

No overview available yet

Prometheus MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "docker",
      "args": [
        "-d",
        "--name",
        "prometheus-mcp-server",
        "-e",
        "PROMETHEUS_URL",
        "shaxiaozz/prometheus-mcp-server:latest"
      ],
      "env": {
        "PROMETHEUS_URL": "http://your-prometheus-server:9090"
      }
    }
  }
}

Prometheus MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Prometheus MCP Server?

A Go-based MCP server that integrates with Prometheus, currently supporting only SSE transport mode. It is for users who want to interact with Prometheus metrics through the Model Context Protocol.

How to use Prometheus MCP Server?

Run the Docker container with environment variables for your Prometheus URL and optional authentication (basic auth or Bearer Token), then configure your MCP client (e.g., Cursor Desktop) with the SSE URL shown in the container logs. The server can be toggled to stdio mode by changing MCP_SERVER_TRANSPORT.

Key features of Prometheus MCP Server

List available Prometheus metrics (prometheus_list_metrics)
Discover and explore Prometheus targets (prometheus_get_targets)
Get metadata for specific metrics (prometheus_get_metric_metadata)
Execute instant PromQL queries (prometheus_execute_query)
Execute range queries with configurable step intervals (prometheus_execute_range_query)
View recent time range query results (prometheus_execute_last_query)
Supports basic authentication and Bearer Token authentication via environment variables

Use cases of Prometheus MCP Server

Query and explore Prometheus metrics from an MCP-compatible client
Automate metric discovery and metadata retrieval for alerting or dashboards
Run instant or range queries for real-time monitoring and troubleshooting
Securely connect to Prometheus with basic auth or token-based authentication

Frequently asked questions

What transport modes does Prometheus MCP Server support?

It supports SSE (Server-Sent Events) by default and can be switched to stdio mode by changing the `MCP_SERVER_TRANSPORT` environment variable.

How do I authenticate to Prometheus from this server?

Authentication is configured via environment variables: either `PROMETHEUS_USERNAME` and `PROMETHEUS_PASSWORD` for basic auth, or `PROMETHEUS_TOKEN` for Bearer Token auth.

Does Prometheus MCP Server require Docker to run?

Yes, the primary deployment method is through Docker. The README provides a Docker run command and instructions for building the image yourself.

Can I build the server image myself?

Yes, you can clone the repository and run `docker build -t prometheus-mcp-server .` to create a custom image.

Where do I find the SSE URL to configure in my MCP client?

After starting the container, run `docker logs prometheus-mcp-server` to see the URL (e.g., `http://10.0.0.1:8000/sse`).

Comments

More Developer Tools MCP servers

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

Termany

thinkany-ai

Agent-Native Terminal

174

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools