pab1it0/prometheus-mcp-server

Give AI assistants the power to query your Prometheus metrics.
A [Model Context Protocol][mcp] (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.
[mcp]: https://modelcontextprotocol.io
Getting Started
Prerequisites
- Prometheus server accessible from your environment
- MCP-compatible client (Claude Desktop, VS Code, Cursor, Windsurf, etc.)
Installation Methods
Claude Desktop
Add to your Claude Desktop configuration:
Claude Code
Install via the Claude Code CLI:
VS Code / Cursor / Windsurf
Add to your MCP settings in the respective IDE:
Docker Desktop
The easiest way to run the Prometheus MCP server is through Docker Desktop:
1. **Via MCP Catalog**: Visit the Prometheus MCP Server on Docker Hub and click the button above
2. **Via MCP Toolkit**: Use Docker Desktop's MCP Toolkit extension to discover and install the server
3. Configure your connection using environment variables (see Configuration Options below)
Manual Docker Setup
Run directly with Docker:
Helm Chart (Kubernetes)
Deploy to Kubernetes using the Helm chart from the OCI registry:
With authentication:
With a custom values file:
See the chart values for all available configuration options.
Configuration Options
| Variable | Description | Required |
|----------|-------------|----------|
| PROMETHEUS_URL | URL of your Prometheus server | Yes |
| PROMETHEUS_URL_SSL_VERIFY | Set to False to disable SSL verification | No |
| PROMETHEUS_DISABLE_LINKS | Set to True to disable Prometheus UI links in query results (saves context tokens) | No |
| PROMETHEUS_REQUEST_TIMEOUT | Request timeout in seconds to prevent hanging requests (DDoS protection) | No (default: 30) |
| PROMETHEUS_USERNAME | Username for basic authentication | No |
| PROMETHEUS_PASSWORD | Password for basic authentication | No |
| PROMETHEUS_TOKEN | Bearer token for authentication | No |
| PROMETHEUS_CLIENT_CERT | Path to client certificate file for mutual TLS authentication | No |
| PROMETHEUS_CLIENT_KEY | Path to client private key file for mutual TLS authentication | No |
| REQUESTS_CA_BUNDLE | Path to CA bundle file for verifying the server's TLS certificate (standard requests library env var) | No |
| ORG_ID | Organization ID for multi-tenant setups | No |
| PROMETHEUS_MCP_SERVER_TRANSPORT | Transport mode (stdio, http, sse) | No (default: stdio) |
| PROMETHEUS_MCP_BIND_HOST | Host for HTTP transport | No (default: 127.0.0.1) |
| PROMETHEUS_MCP_BIND_PORT | Port for HTTP transport | No (default: 8080) |
| PROMETHEUS_MCP_STATELESS_HTTP | Enable stateless HTTP mode for multi-replica support | No (default: False) |
| PROMETHEUS_CUSTOM_HEADERS | Custom headers as JSON string | No |
| TOOL_PREFIX | Prefix for all tool names (e.g., staging results in staging_execute_query). Useful for running multiple instances targeting different environments in Cursor | No |
Available Tools
| Tool | Category | Description |
| --- | --- | --- |