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