MCP.so
Sign In

prometheus-mcp-server

@weetime

Repository

About prometheus-mcp-server

No overview available yet

Config

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

{
  "mcpServers": {
    "prometheus-mcp-server-weetime": {
      "command": "npx",
      "args": [
        "prometheus-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is prometheus-mcp-server?

A TypeScript-based Model Context Protocol (MCP) server that bridges Claude and Prometheus, enabling querying of metrics, series, labels, alerts, rules, and server status via PromQL.

How to use prometheus-mcp-server?

Install globally with npm install -g prometheus-mcp-server or run via npx prometheus-mcp-server. Configure the Prometheus URL using the PROMETHEUS_BASE_URL environment variable (defaults to http://localhost:9090). Add the server to Claude Desktop’s config file (MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json) with the appropriate command and env settings.

Key features of prometheus-mcp-server

  • Instant PromQL queries at a specific time
  • Range PromQL queries over a time period
  • Series discovery by label matchers
  • Label name and value exploration
  • Metadata access for metrics
  • Target information from scrape configurations
  • Alerts and recording/alerting rules
  • Prometheus server status information

Use cases of prometheus-mcp-server

  • Query current metric values for dashboards or alerting checks.
  • Retrieve time-series data over a window for analysis or reporting.
  • Discover available series and labels to explore the metric schema.
  • Inspect scrape targets, alerts, and rules for operational monitoring.
  • Get server status to verify Prometheus health and configuration.

FAQ from prometheus-mcp-server

How do I configure the Prometheus server URL?

Set the PROMETHEUS_BASE_URL environment variable to the desired Prometheus HTTP endpoint. The default is http://localhost:9090.

What functions does prometheus-mcp-server expose?

It provides nine MCP functions: mcp__instant_query, mcp__range_query, mcp__get_series, mcp__get_label_values, mcp__get_metadata, mcp__get_targets, mcp__get_alerts, mcp__get_rules, and mcp__get_status.

How can I run prometheus-mcp-server without installing it?

Use npx: npx prometheus-mcp-server. You can also set the PROMETHEUS_BASE_URL environment variable inline when using npx.

What transport does the server use?

It communicates over stdio, as is standard for MCP servers (mentioning stdio in the Debugging section for inspecting and debugging).

Are there any runtime dependencies beyond Node.js?

The server is a TypeScript project that compiles to JavaScript; Node.js is required to run it. All dependencies are bundled via npm.

Frequently asked questions

How do I configure the Prometheus server URL?

Set the `PROMETHEUS_BASE_URL` environment variable to the desired Prometheus HTTP endpoint. The default is `http://localhost:9090`.

What functions does prometheus-mcp-server expose?

It provides nine MCP functions: `mcp__instant_query`, `mcp__range_query`, `mcp__get_series`, `mcp__get_label_values`, `mcp__get_metadata`, `mcp__get_targets`, `mcp__get_alerts`, `mcp__get_rules`, and `mcp__get_status`.

How can I run prometheus-mcp-server without installing it?

Use npx: `npx prometheus-mcp-server`. You can also set the `PROMETHEUS_BASE_URL` environment variable inline when using npx.

What transport does the server use?

It communicates over stdio, as is standard for MCP servers (mentioning stdio in the Debugging section for inspecting and debugging).

Are there any runtime dependencies beyond Node.js?

The server is a TypeScript project that compiles to JavaScript; Node.js is required to run it. All dependencies are bundled via npm.

Comments

Basic information

Category

Developer Tools

Transports

stdio

Author

weetime

More Developer Tools MCP servers

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

extentos

Asger mølgaard

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses:

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI MCP Server — career, labor market, and business idea intelligence for AI agents. 11 tools covering real-time FRED labor market signals, BLS wage data (126 occupations), AI-generated app ideas, career paths,