Prometheus MCP Server
About
A Model Context Protocol (MCP) server that enables AI agents and LLMs to query and analyze Prometheus metrics through standardized interfaces.
Details
- License
- GPL-3.0 license
Explore
- Execute PromQL queries against Prometheus
- Discover and explore metrics
- List available metrics
- Get metadata for specific metrics
- Search metric metadata by name or description in a single call
- View instant query results
- View range query results with different step intervals
- Authentication support
- Basic auth from environment variables
- Bearer token auth from environment variables
- Docker containerization support
- Provide interactive tools for AI assistants
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Prometheus MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Prerequisites
- Prometheus server accessible from your environment
- MCP-compatible client (Claude Desktop, VS Code, Cursor, Windsurf, etc.)
health_check
System
execute_query
Query
execute_range_query
Query
list_metrics
Discovery
get_metric_metadata
Discovery
get_targets
Discovery
| Tool | Category | Description |
| --- | --- | --- |
| health_check | System | Health check endpoint for container monitoring and status verification |
| execute_query | Query | Execute a PromQL instant query against Prometheus |
| execute_range_query | Query | Execute a PromQL range query with start time, end time, and step interval |
| list_metrics | Discovery | List all available metrics in Prometheus with pagination and filtering support |
| get_metric_metadata | Discovery | Get metadata for one metric or bulk metadata with optional filtering |
| get_targets | Discovery | Get information about all scrape targets |
The list of tools is configurable, so you can choose which tools you want to make available to the MCP client. This is useful if you don't use certain functionality or if you don't want to take up too much of the context window.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"prometheus mcp server": {
"prometheus-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"\\"
]
}
}
}
}McpServers
{
"prometheus-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"\\"
]
}
}
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
<details>
<summary><b>Claude Desktop</b></summary>
Add to your Claude Desktop configuration:
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server:latest"
],
"env": {
"PROMETHEUS_URL": "<your-prometheus-url>"
}
}
}
}
<details>
<summary><b>Claude Code</b></summary>
Install via the Claude Code CLI:
claude mcp add prometheus --env PROMETHEUS_URL=http://your-prometheus:9090 -- docker run -i --rm -e PROMETHEUS_URL ghcr.io/pab1it0/prometheus-mcp-server:latest
<details>
<summary><b>VS Code / Cursor / Windsurf</b></summary>
Add to your MCP settings in the respective IDE:
{
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server:latest"
],
"env": {
"PROMETHEUS_URL": "<your-prometheus-url>"
}
}
}
<details>
<summary><b>Docker Desktop</b></summary>
The easiest way to run the Prometheus MCP server is through Docker Desktop:
<a href="https://hub.docker.com/open-desktop?url=https://open.docker.com/dashboard/mcp/servers/id/prometheus/config?enable=true">
</a>
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)
</details>
<details>
<summary><b>Manual Docker Setup</b></summary>
Run directly with Docker:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
