A Model Context Protocol (MCP) server that enables AI assistants to query and analyze Prometheus metrics through standardized interfaces. Connect to your Prometheus instance to retrieve metrics, perform queries, and gain insights into your system's performance and health.
6 Tools
Version 4.43 or later needs to be installed to add the server automatically
Use cases
About
A Model Context Protocol (MCP) server that enables AI assistants to query and analyze Prometheus metrics through standardized interfaces. Connect to your Prometheus instance to retrieve metrics, perform queries, and gain insights into your system's performance and health.
| Attribute | Details |
|---|---|
| Docker Image | ghcr.io/pab1it0/prometheus-mcp-server |
| Author | pab1it0 |
| Repository | https://github.com/pab1it0/prometheus-mcp-server |
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/pab1it0/prometheus-mcp-server/blob/219d4f0772cfb035d702e1d7c64643baf60b3479/Dockerfile |
| Commit | 219d4f0772cfb035d702e1d7c64643baf60b3479 |
| Docker Image built by | pab1it0 |
| Docker Scout Health Score | Not available |
| Verify Signature | Not available |
| Licence | MIT License |
| Tools provided by this Server | Short Description |
|---|---|
execute_query | Execute PromQL Query |
execute_range_query | Execute PromQL Range Query |
get_metric_metadata | Get Metric Metadata |
get_targets | Get Scrape Targets |
health_check | Health Check |
list_metrics | List Available Metrics |
execute_queryExecute a PromQL instant query against Prometheus
| Parameters | Type | Description |
|---|---|---|
query | string | |
time | stringoptional |
This tool is read-only. It does not modify its environment.
This tool interacts with external entities.
execute_range_queryExecute a PromQL range query with start time, end time, and step interval
| Parameters | Type | Description |
|---|---|---|
end | string | |
query | string | |
start | string | |
step | string |
This tool is read-only. It does not modify its environment.
This tool interacts with external entities.
get_metric_metadataGet metadata for a specific metric
| Parameters | Type | Description |
|---|---|---|
metric | string |
This tool is read-only. It does not modify its environment.
This tool interacts with external entities.
get_targetsGet information about all scrape targets
health_checkHealth check endpoint for container monitoring and status verification
list_metricsList all available metrics in Prometheus with optional pagination support
| Parameters | Type | Description |
|---|---|---|
filter_pattern | stringoptional | |
limit | stringoptional | |
offset | integeroptional |
This tool is read-only. It does not modify its environment.
This tool interacts with external entities.
{
"mcpServers": {
"prometheus": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PROMETHEUS_URL",
"ghcr.io/pab1it0/prometheus-mcp-server"
],
"env": {
"PROMETHEUS_URL": "http://host.docker.internal:9090"
}
}
}
}