msrashed-prometheus-mcp-server

# Prometheus MCP Server A read-only Model Context Protocol (MCP) server for [Prometheus](https://prometheus.io/), enabling AI agents like Claude to query metrics, investigate alerts, and analyze monitoring data safely. [](https://www.python.org/downloads/) [](https://github.com/anthropics/mcp) [](https://opensource.org/licenses/MIT) ## Features - **Read-Only Safety**: All operations are read-only. No modifications to Prometheus configuration or data - **Comprehensive Query Support**: Execute PromQL instant and range queries - **Metadata Discovery**: List metrics, labels, and series - **Target Monitoring**: View scrape targets and their health - **Alert Investigation**: List active alerts and alert rules - **Configuration Inspection**: View Prometheus configuration and runtime info - **Multiple Auth Methods**: Support for Bearer tokens and Basic authentication - **Type-Safe**: Full type hints for Python 3.12+ ## Installation ### Using uv (Recommended) ```bash # Clone the repository git clone <repository-url> cd prometheus-mcp-server # Install with uv uv pip install -e . # Or install from PyPI (when published) uv pip install prometheus-mcp-server ``` ### Using pip ```bash pip install prometheus-mcp-server ``` ### Using pipx (for CLI usage) ```bash pipx install prometheus-mcp-server ``` ## Quick Start ### 1. Set Environment Variables ```bash # Prometheus server URL (required) export PROM_URL="http://localhost:9090" # Optional: Bearer token authentication export PROM_TOKEN="your_bearer_token" # Optional: Basic authentication export PROM_USERNAME="admin" export PROM_PASSWORD="secret" # Optional: Timeout and SSL settings export PROM_TIMEOUT="30" export PROM_VERIFY_SSL="true" ``` ### 2. Run the Server ```bash # Using stdio transport (default, for Claude Desktop)…