Prometheus MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Prometheus, enabling AI assistants to query metrics, discover available data, and analyze system performance through natural language interactions.

Features

Real-time Metrics Access - Query current and historical metrics data
Metrics Discovery - Find available metrics and monitoring targets
Multiple Auth Methods - Basic auth, bearer tokens, and TLS support
Type-safe - Full TypeScript implementation

MCP Configuration

Using npx (Recommended)

Add to your MCP client settings:

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["prometheus-mcp-server"],
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

Using global installation

First install the package globally:

npm install -g prometheus-mcp-server

Then configure your MCP client:

{
  "mcpServers": {
    "prometheus": {
      "command": "prometheus-mcp-server",
      "env": {
        "PROMETHEUS_URL": "http://localhost:9090"
      }
    }
  }
}

Environment Variables

# Required
PROMETHEUS_URL=http://localhost:9090

# Optional Authentication
PROMETHEUS_USERNAME=admin
PROMETHEUS_PASSWORD=password
PROMETHEUS_TOKEN=bearer-token

# Optional Connection
PROMETHEUS_TIMEOUT=10000
PROMETHEUS_INSECURE=false

Available Tools

Tool	Description	Use Case
`prom_query`	Execute PromQL instant query	Get current metric values, alerts status
`prom_range`	Execute PromQL range query	Analyze trends, create graphs, historical data
`prom_discover`	Discover available metrics	Explore what metrics are available in your system
`prom_metadata`	Get metric metadata	Understand metric types, descriptions, and units
`prom_targets`	Get scrape targets info	Monitor scraping health and service discovery

Example Usage

Ask your AI assistant natural language questions:

"What's the current CPU usage across all servers?"
"Show me HTTP request rates for the last 6 hours"
"Which services have the highest memory consumption?"
"Are there any failing health checks?"
"What metrics are available for monitoring my database?"

Development

# Run with inspector
npm run inspector

# Run directly
npm run dev

Connection Methods

1. No Authentication

export PROMETHEUS_URL=http://localhost:9090

2. Basic Authentication

export PROMETHEUS_URL=http://localhost:9090
export PROMETHEUS_USERNAME=admin
export PROMETHEUS_PASSWORD=secret

3. Bearer Token

export PROMETHEUS_URL=https://prometheus.example.com:9090
export PROMETHEUS_TOKEN=your-bearer-token

Additional Options

For self-signed certificates or development:

export PROMETHEUS_INSECURE=true

License

MIT