mcp-server-prometheus

What is mcp-server-prometheus?

mcp-server-prometheus is a TypeScript-based MCP server that implements a Prometheus API interface. It provides a bridge between Claude and your Prometheus server through the Model Context Protocol (MCP), enabling interaction with Prometheus metrics and data.

How to use mcp-server-prometheus?

Configure the required environment variable PROMETHEUS_URL (and optionally PROMETHEUS_USERNAME and PROMETHEUS_PASSWORD for basic auth). Add the server to your Claude Desktop config JSON with the path to the built index.js file, then start Claude.

Key features of mcp-server-prometheus

• List and access Prometheus metric schema
• Each metric provides name, description, and detailed metadata
• Exposes statistical information (count, min, max) per metric
• Supports basic authentication for secured Prometheus instances
• Returns data in JSON mime type for structured access

Use cases of mcp-server-prometheus

• Query and browse Prometheus metrics through Claude using natural language
• Retrieve detailed metadata and statistics for monitoring analysis
• Integrate Prometheus observability data directly into Claude-powered workflows

FAQ from mcp-server-prometheus

What environment variables are required to run mcp-server-prometheus?

PROMETHEUS_URL is required. PROMETHEUS_USERNAME and PROMETHEUS_PASSWORD are optional for basic auth.

What kind of data does mcp-server-prometheus expose?

It exposes Prometheus metric schema, metadata (help text, type), and statistical data (count, min, max) for each metric.

How is mcp-server-prometheus installed and configured?

Install dependencies with npm install, build with npm run build, then add the server configuration to your Claude Desktop JSON config file.

Can I debug mcp-server-prometheus?

Yes, use the MCP Inspector by running npm run inspector in the project directory.

What authentication methods are supported?

The server supports basic authentication via the PROMETHEUS_USERNAME and PROMETHEUS_PASSWORD environment variables.