pmcp

Name: pmcp
Author: yshngg

@yshngg

Repository

About pmcp

A Prometheus Model Context Protocol Server.

#pmcp #prometheus #monitoring

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "pmcp": {
      "command": "docker",
      "args": [
        "pull",
        "ghcr.io/yshngg/prometheus-mcp-server:latest"
      ]
    }
  }
}

Tools

Return currently loaded configuration file

Return flag values that Prometheus was configured with

Trigger a reload of the Prometheus configuration and rule files

Trigger a graceful shutdown of Prometheus

Overview

What is pmcp?

pmcp is a Golang-based Model Context Protocol (MCP) server implementation for Prometheus that enables natural language interactions with Prometheus metrics and queries. Built with Go 1.23+, it provides a type-safe interface fully compatible with the Prometheus HTTP API v1 and works with MCP-compatible clients like Claude Desktop.

How to use pmcp?

Install via Docker, pre-built binary, building from source, or go install. Run with prometheus-mcp-server --prom-addr="http://localhost:9090" for default stdio transport, or specify --transport=http and --mcp-addr for HTTP/SSE. See command line flags: -prom-addr, -transport, -mcp-addr, -help, -version.

Key features of pmcp

Golang implementation for performance and type safety
Complete Prometheus HTTP API v1 coverage
Instant and range query execution
Metadata, target, rule, and alert discovery
TSDB administration (snapshots, series deletion, tombstones)
Multiple transports: HTTP, SSE, and stdio

Use cases of pmcp

Query Prometheus metrics using natural language through MCP clients
Monitor Prometheus targets, rules, and alerting configurations
Retrieve historical metric data over defined time ranges
Manage TSDB operations like snapshots and series deletion
Integrate Prometheus with MCP-compatible desktop or web clients

FAQ from pmcp

What are the requirements to run pmcp?

Go 1.23.0 or higher, a running Prometheus server (v2.x), and a compatible MCP client (e.g., Claude Desktop).

What transport options are available?

pmcp supports three transports: stdio (default for desktop clients), http, and sse (SSE is deprecated). Use the --transport flag to choose.

Does pmcp support all Prometheus API endpoints?

Yes, pmcp maintains 100% compatibility with the Prometheus HTTP API v1. It covers queries, metadata, rules, alerts, status, TSDB administration, and management APIs.

Can I use pmcp with Claude Desktop?

Yes, pmcp is designed for seamless communication with MCP-compatible clients like Claude Desktop, typically using the stdio transport when launched as a subprocess.