English Français العربية

Pmcp

Community Other

Prometheus integration.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Prometheus MCP Server
  2. Installation
  3. Usage
  4. Tools
  5. Resources
  6. Prompts
  7. License

Prometheus MCP Server

A Go-based MCP server that exposes Prometheus query capabilities via the Model Context Protocol.

Installation

go install github.com/yshngg/prometheus-mcp-server@latest

Or pull the Docker image:

docker pull ghcr.io/yshngg/prometheus-mcp-server:latest

Usage

prometheus-mcp-server --prom-addr="http://localhost:9090"
Flags
FlagDefaultDescription
-prom-addrhttp://localhost:9090Prometheus server URL
-mcp-addrlocalhost:8080MCP server listen address
-transportstdiostdio or http
-auth-token``Bearer token for MCP endpoint authentication (optional)
-versionPrint 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:

{
  "mcpServers": {
    "prometheus": {
      "command": "prometheus-mcp-server",
      "args": ["--prom-addr", "http://localhost:9090"]
    }
  }
}

[!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:

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/yshngg/prometheus-mcp-server:latest",
        "--prom-addr",
        "http://host.docker.internal:9090"
      ]
    }
  }
}
Client-specific configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "prometheus": {
      "command": "prometheus-mcp-server",
      "args": ["--prom-addr", "http://localhost:9090"]
    }
  }
}

With Docker:

{
  "mcpServers": {
    "prometheus": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/yshngg/prometheus-mcp-server:latest",
        "--prom-addr",
        "http://host.docker.internal:9090"
      ]
    }
  }
}

OpenCode

Add to opencode.json (guide):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "prometheus": {
      "type": "local",
      "command": [
        "prometheus-mcp-server",
        "--prom-addr",
        "http://localhost:9090"
      ]
    }
  }
}

HTTP Transport

Run the server with HTTP transport:

prometheus-mcp-server --transport=http --mcp-addr="localhost:8080"

Then configure your client to use http://localhost:8080/mcp.

For authenticated access, set AUTH_TOKEN:

AUTH_TOKEN=my-token prometheus-mcp-server --transport=http

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:

URIDescription
prom:///configCurrently loaded configuration (YAML)
prom:///flagsCommand-line flag values
prom:///runtime-infoRuntime information
prom:///build-infoBuild information
prom:///tsdb-statsTSDB cardinality statistics
prom:///wal-replay-statsWAL replay state
Resource Templates

URI templates for dynamic data access:

TemplateDescription
prom:///api/v1/query?query={promql}Instant PromQL query result
prom:///api/v1/label/{name}/valuesLabel values for a given label name

Prompts

NameArgumentsDescription
all-available-metricsprefix (optional)Lists all metric names in the Prometheus instance

License

Apache License 2.0

Frequently asked questions

What is Pmcp?

Prometheus integration.

How do I install Pmcp?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is Pmcp open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains Pmcp?

It is published by yshngg. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.