Skip to content

pab1it0/prometheus-mcp-server

MCP Data & Storage

A Model Context Protocol server that exposes Prometheus metrics to AI assistants via standardized MCP interfaces

Python Latest v1.6.1 · 1mo ago Security brief →

Features

  • Exposes PromQL query execution through the Model Context Protocol (MCP)
  • Works with Claude Desktop, VS Code, Cursor, Windsurf and other MCP‑compatible clients
  • Configurable authentication (basic auth, bearer token, mutual TLS)
  • Supports multiple transport modes (stdio, HTTP, Server‑Sent Events)
  • Easy deployment via Docker or Helm chart

Recent releases

View all 31 releases →
v1.6.1 New feature
Notable features
  • Helm chart added with OCI registry publishing support
  • /health endpoint introduced; stateless_http enabled for multi‑replica configurations
Full changelog

What's Changed

  • feat: add Helm chart with OCI registry publishing by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/138
  • chore(deps): upgrade MCP Python SDK to 1.26.0 by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/139
  • docs: add README for Helm chart by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/140
  • chore(deps): bump pyjwt from 2.10.1 to 2.12.0 by @dependabot[bot] in https://github.com/pab1it0/prometheus-mcp-server/pull/142
  • chore(deps): bump authlib from 1.6.7 to 1.6.9 by @dependabot[bot] in https://github.com/pab1it0/prometheus-mcp-server/pull/144
  • chore: remove trivy security scanning workflow by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/145
  • chore(deps): bump fastmcp from 3.1.0 to 3.2.0 by @dependabot[bot] in https://github.com/pab1it0/prometheus-mcp-server/pull/151
  • chore(deps): bump cryptography from 46.0.5 to 46.0.7 by @dependabot[bot] in https://github.com/pab1it0/prometheus-mcp-server/pull/153
  • Remove unused dependency pyproject-toml by @pizzapim in https://github.com/pab1it0/prometheus-mcp-server/pull/160
  • chore(deps): bump python-dotenv from 1.1.1 to 1.2.2 by @dependabot[bot] in https://github.com/pab1it0/prometheus-mcp-server/pull/158
  • chore(deps): bump requests from 2.32.5 to 2.33.0 by @dependabot[bot] in https://github.com/pab1it0/prometheus-mcp-server/pull/147
  • chore(deps): bump authlib from 1.6.9 to 1.6.11 by @dependabot[bot] in https://github.com/pab1it0/prometheus-mcp-server/pull/157
  • feat: add /health endpoint and enable stateless_http for multi-replic… by @miquelbar in https://github.com/pab1it0/prometheus-mcp-server/pull/159
  • chore: bump version to 1.6.1 by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/161

New Contributors

  • @pizzapim made their first contribution in https://github.com/pab1it0/prometheus-mcp-server/pull/160
  • @miquelbar made their first contribution in https://github.com/pab1it0/prometheus-mcp-server/pull/159

Full Changelog: https://github.com/pab1it0/prometheus-mcp-server/compare/v1.6.0...v1.6.1

v1.6.0 New feature
Security fixes
  • Mutual TLS support for secure Prometheus connections
Notable features
  • Bulk metric metadata retrieval with filtering and pagination
  • Mutual TLS client certificate authentication support
  • Metric caching with refresh_cache option
Full changelog

What's Changed

  • docs: refactor README for better user experience by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/125
  • feat: add bulk metric metadata retrieval with filtering and pagination by @Yb2411 in https://github.com/pab1it0/prometheus-mcp-server/pull/130
  • fix: upgrade to FastMCP 3.x and fix CI test failures by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/135
  • feat: add mutual TLS (client certificate) authentication support by @freeformz in https://github.com/pab1it0/prometheus-mcp-server/pull/133
  • fix: use cached metrics in list_metrics and add refresh_cache option by @freeformz in https://github.com/pab1it0/prometheus-mcp-server/pull/134
  • chore: bump version to 1.6.0 by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/137

New Contributors

  • @Yb2411 made their first contribution in https://github.com/pab1it0/prometheus-mcp-server/pull/130
  • @freeformz made their first contribution in https://github.com/pab1it0/prometheus-mcp-server/pull/133

Full Changelog: https://github.com/pab1it0/prometheus-mcp-server/compare/v1.5.3...v1.6.0

v1.5.3 New feature
Notable features
  • TOOL_PREFIX environment variable for multi-instance deployment
  • Configurable timeouts for Prometheus HTTP requests
Full changelog

What's Changed

  • Apply latest MCP registry changes by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/113
  • feat: add TOOL_PREFIX env var for multi-instance support by @bmonsalvatge-alpaca in https://github.com/pab1it0/prometheus-mcp-server/pull/115
  • Add configurable timeout to all Prometheus HTTP requests to prevent resource exhaustion by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/109
  • chore: bump version to 1.5.3 by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/116

New Contributors

  • @bmonsalvatge-alpaca made their first contribution in https://github.com/pab1it0/prometheus-mcp-server/pull/115

Full Changelog: https://github.com/pab1it0/prometheus-mcp-server/compare/v1.5.1...v1.5.3

v1.5.1 New feature
Notable features
  • Custom headers for Prometheus requests
Full changelog

What's Changed

  • feature: custom headers passing for each prometheus request. by @akhromium in https://github.com/pab1it0/prometheus-mcp-server/pull/106
  • Update contributing guidelines to industry standard by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/107
  • Remove image build from CI pipeline by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/108

New Contributors

  • @akhromium made their first contribution in https://github.com/pab1it0/prometheus-mcp-server/pull/106

Full Changelog: https://github.com/pab1it0/prometheus-mcp-server/compare/v1.5.0...v1.5.1

v1.5.0 New feature
Notable features
  • MCP SDK v1.21.0 upgrade
  • Pagination support
Full changelog

What's Changed

  • Update get_metric_metadata by @mjnchen in https://github.com/pab1it0/prometheus-mcp-server/pull/97
  • Upgrade MCP SDK to v1.21.0 and Add Pagination Support by @pab1it0 in https://github.com/pab1it0/prometheus-mcp-server/pull/105

Full Changelog: https://github.com/pab1it0/prometheus-mcp-server/compare/v1.4.6...v1.5.0

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
450
Forks
95
Languages
Python Dockerfile Go Template

Install & Platforms

Install via
docker helm

Beta — feedback welcome: [email protected]