mcp-server-prometheus

MCP server for interacting with Prometheus metrics and data.

This 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).

Demo

Features

Resources

• List and access Prometheus metric schema
• Each metric resource provides:
• Metric name and description
• Detailed metadata from Prometheus
• Statistical information (count, min, max)
• JSON mime type for structured data access

Current Capabilities

• List all available Prometheus metrics with descriptions
• Read detailed metric information including:
• Metadata and help text
• Current statistical data (count, min, max values)
• Basic authentication support for secured Prometheus instances

Configuration

The server requires the following environment variable:

• PROMETHEUS_URL: The base URL of your Prometheus instance

Optional authentication configuration:

• PROMETHEUS_USERNAME: Username for basic auth (if required)
• PROMETHEUS_PASSWORD: Password for basic auth (if required)

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-prometheus": {
      "command": "/path/to/mcp-server-prometheus/build/index.js",
      "env": {
        "PROMETHEUS_URL": "http://your-prometheus-instance:9090"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

API Structure

The server exposes Prometheus metrics through the following URI structure:

• Base URI: http://your-prometheus-instance:9090
• Metric URIs: http://your-prometheus-instance:9090/metrics/{metric_name}

Each metric resource returns JSON data containing:

• Metric name
• Metadata (help text, type)
• Current statistics (count, min, max)