MCP.so
Sign In

prometheus-mcp-server

@yshngg

Repository

About prometheus-mcp-server

A Prometheus Model Context Protocol Server.

#prometheus#monitoring#server

Config

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

{
  "mcpServers": {
    "prometheus-mcp-server-yshngg": {
      "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 prometheus-mcp-server?

A Golang-based Model Context Protocol (MCP) server that enables natural language interactions with Prometheus metrics and queries. It acts as a bridge between MCP-compatible clients (like Claude Desktop) and Prometheus servers, providing full compatibility with the Prometheus HTTP API v1.

How to use prometheus-mcp-server?

Run the server by specifying the Prometheus address and transport. Use Docker, a pre-built binary, or build from source. Example: prometheus-mcp-server --prom-addr="http://localhost:9090" (defaults to stdio transport). Configurable flags: -prom-addr, -transport (stdio, http, sse), -mcp-addr.

Key features of prometheus-mcp-server

  • Complete Prometheus API v1 coverage via MCP tools
  • Instant and range query execution
  • Metadata discovery (series, labels, values)
  • Target, rule, and alert management
  • TSDB administration (snapshots, series deletion)
  • Multiple transport options (HTTP, SSE, stdio)

Use cases of prometheus-mcp-server

  • Query Prometheus metrics using natural language from an MCP client
  • Monitor alerting rules and targets without writing PromQL directly
  • Retrieve historical metric data over defined time ranges
  • Perform administrative tasks like TSDB snapshots or series deletion
  • Integrate Prometheus observability into AI-powered assistants

FAQ from prometheus-mcp-server

—

What dependencies are required?

Go 1.23+ and a running Prometheus server v2.x, plus a compatible MCP client.

How is data accessed?

All queries go directly against the Prometheus HTTP API; no data is stored locally by the server.

What transport protocols are supported?

stdio (default), HTTP, and SSE (deprecated). HTTP is recommended for web integrations.

Are there any known limitations?

—

How is authentication handled?

—

Frequently asked questions

What dependencies are required?

Go 1.23+ and a running Prometheus server v2.x, plus a compatible MCP client.

How is data accessed?

All queries go directly against the Prometheus HTTP API; no data is stored locally by the server.

What transport protocols are supported?

stdio (default), HTTP, and SSE (deprecated). HTTP is recommended for web integrations.

Comments

Basic information

Category

Developer Tools

License

Apache-2.0

Transports

stdio

Author

yshngg

More Developer Tools MCP servers

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

1

Repo Test Architect

RepoAssay

Local-first, read-only MCP server for evidence-backed repository test architecture audits and test planning.

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

1

Rams

HSLA0001 Inc.

Design review for UI code, inside your agent. One tool (review_files): up to 20 files in, a scored review out — 0–100, issues with severity and file:line, a concrete fix for each. 258 versioned rules across accessibility

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K