Prometheus MCP Server

@shaxiaozz

About Prometheus MCP Server

No overview available yet

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"
      }
    }
  }
}

Tools

No tools detected

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

FAQ from Prometheus MCP Server

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).

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

Basic information

More Developer Tools MCP servers

Agent Conductor

icohangar-ops

Agent conductor — AGENTS.md contract parser, SKILL.md registry, CHP decision engine over MCP

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

Kaiva Bridge

Kaiva Bridge turns any Postgres database or OpenAPI spec into a secure, hosted MCP server — per-tool access control, every call audited. Dependency Trust gives coding agents the senior-engineer check before adding a dep

CodeSentinel

icohangar-ops

Codebase health as MCP tools: dead code, circular dependencies, coupling, architectural drift.