Prometheus MCP Server

Name: Prometheus MCP Server
Author: pab1it0

@pab1it0

Prometheus MCP Server について

A Model Context Protocol (MCP) server that enables AI agents and LLMs to query and analyze Prometheus metrics through standardized interfaces.

#devops #ai #mcp #prometheus #llm

基本情報

カテゴリ

開発者ツール

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

pab1it0

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "prometheus-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "\\"
      ]
    }
  }
}

ツール

System

Query

Discovery

概要

What is Prometheus MCP Server?

Prometheus MCP Server is a Model Context Protocol server that gives AI assistants the power to query your Prometheus metrics and execute PromQL queries through standardized MCP interfaces. It is intended for users of MCP-compatible clients such as Claude Desktop, VS Code, Cursor, or Windsurf who need to analyze metrics data from a Prometheus server.

How to use Prometheus MCP Server?

Install and run the server via Docker, or deploy to Kubernetes using the provided Helm chart. Configure it by setting the PROMETHEUS_URL environment variable to point to your Prometheus server, plus optional authentication and transport variables. Add the server to your MCP client’s configuration (for example, Claude Desktop or VS Code) using the Docker command shown in the README.

Key features of Prometheus MCP Server

Execute instant and range PromQL queries against Prometheus
Discover and explore metrics with pagination and filtering
Get metadata for metrics and search by name or description
View scrape target information
Support for basic auth, bearer token, and mutual TLS authentication
Configurable transport modes (stdio, HTTP, SSE)

Use cases of Prometheus MCP Server

AI-assisted monitoring and alert troubleshooting using PromQL
Automated metric exploration and analysis in development workflows
Querying historical metrics for root cause analysis
Integrating Prometheus data with AI-powered dashboards and assistants

FAQ from Prometheus MCP Server

What do I need to run Prometheus MCP Server?

You need a Prometheus server accessible from your environment and an MCP-compatible client such as Claude Desktop, VS Code, Cursor, or Windsurf.

How do I connect the server to my Prometheus instance?

Set the PROMETHEUS_URL environment variable to the URL of your Prometheus server. Optional authentication can be configured via PROMETHEUS_USERNAME and PROMETHEUS_PASSWORD, PROMETHEUS_TOKEN, or client certificate variables.