yshngg/pmcp

A Go-based MCP server that exposes Prometheus query capabilities via the Model Context Protocol.
Installation
Or pull the Docker image:
Usage
Flags
| Flag | Default | Description |
| ------------- | ----------------------- | ------------------------------------------------------- |
| -prom-addr | http://localhost:9090 | Prometheus server URL |
| -mcp-addr | localhost:8080 | MCP server listen address |
| -transport | stdio | stdio or http |
| -auth-token | | Bearer token for MCP endpoint authentication (optional) |
| -version | | Print version |
Environment Variables
All flags can be set via environment variables: PROM_ADDR, MCP_ADDR, TRANSPORT, AUTH_TOKEN.
MCP Client Configuration
Add the following config to your MCP client:
> [!NOTE]
> Install the binary via go install github.com/yshngg/prometheus-mcp-server@latest or pull the Docker image with docker pull ghcr.io/yshngg/prometheus-mcp-server:latest.
If you don't have the binary installed, use Docker:
Client-specific configuration
Claude Desktop
Add to claude_desktop_config.json:
With Docker:
OpenCode
Add to opencode.json ( guide ):
HTTP Transport
Run the server with HTTP transport:
Then configure your client to use http://localhost:8080/mcp.
For authenticated access, set AUTH_TOKEN:
Your client must then include Authorization: Bearer my-token in requests to /mcp.
Tools
**Expression:** instant_query, range_query
**Metadata:** find_series_by_labels, list_label_names, list_label_values, target_metadata_query, metric_metadata_query
**Discovery:** target_discovery, alert_query, rule_query, alertmanager_discovery
**TSDB Admin:** tsdb_snapshot, delete_series, clean_tombstones
**Management:** health_check, readiness_check, reload, quit
Resources
The server exposes Prometheus data as URI-addressable resources under the prom:/// scheme:
| URI | Description |
| -------------------------- | ------------------------------------- |
| prom:///config | Currently loaded configuration (YAML) |
| prom:///flags | Command-line flag values |
| prom:///runtime-info | Runtime information |
| prom:///build-info | Build information |
| prom:///tsdb-stats | TSDB cardinality statistics |
| prom:///wal-replay-stats | WAL replay state |
Resource Templates
URI templates for dynamic data access:
| Template | Description |
| ------------------------------------- | ----------------------------------- |