MCP.so
Sign In

pmcp

@yshngg

Repository

About pmcp

A Prometheus Model Context Protocol Server.

#pmcp#prometheus#monitoring

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

4

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.

Frequently asked questions

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.

Comments

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

yshngg

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

Peekaboo MCP – lightning-fast macOS screenshots for AI agents

steipete

Peekaboo is a macOS CLI & optional MCP server that enables AI agents to capture screenshots of applications, or the entire system, with optional visual question answering through local or remote AI models.

4.8K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K