prometheus-mcp 0.1.0__tar.gz

prometheus_mcp-0.1.0/.env.example

@@ -0,0 +1,15 @@
+# Copy this file to .env and fill in your values.
+# Never commit .env to version control.
+
+# Required: Prometheus server URL (no trailing slash)
+PROMETHEUS_URL=https://prometheus.example.com
+
+# Optional: Bearer token for authentication (takes precedence over Basic auth)
+# PROMETHEUS_TOKEN=your-token-here
+
+# Optional: HTTP Basic auth credentials (used only when PROMETHEUS_TOKEN is not set)
+# PROMETHEUS_USERNAME=admin
+# PROMETHEUS_PASSWORD=secret
+
+# Optional: Set to 'false' to skip TLS certificate verification (e.g. for self-signed certs)
+# PROMETHEUS_SSL_VERIFY=true

prometheus_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,67 @@
+name: Publish to PyPI
+
+# Fires when a tag like v0.1.0, v1.0.0rc1 is pushed.
+# Builds the sdist+wheel once, then publishes to PyPI using a
+# Trusted Publisher (OIDC — no API token stored anywhere).
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: python -m pip install --upgrade build
+
+      - name: Verify tag matches package version
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          PKG=$(python -c "import tomllib, pathlib; print(tomllib.loads(pathlib.Path('pyproject.toml').read_text())['project']['version'])")
+          echo "tag=$TAG  pyproject.version=$PKG"
+          if [ "$TAG" != "$PKG" ]; then
+            echo "::error::Tag v$TAG does not match pyproject version $PKG"
+            exit 1
+          fi
+
+      - name: Build
+        run: python -m build
+
+      - name: Upload dist artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/prometheus-mcp/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

prometheus_mcp-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e '.[dev]'
+
+      - name: Lint with ruff
+        run: |
+          ruff check src tests
+          ruff format --check src tests
+
+      - name: Run tests with coverage
+        run: |
+          pytest tests/ -v --cov=src/prometheus_mcp --cov-report=term-missing

prometheus_mcp-0.1.0/.gitignore

@@ -0,0 +1,66 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+.env
+
+# Testing
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+htmlcov/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyright/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Dist
+*.tar.gz
+*.whl

prometheus_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to `prometheus-mcp` will be documented in this file.
+
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+versioning: [SemVer](https://semver.org/).
+
+## [0.1.0] — 2026-04-18
+
+### Added
+
+- `prometheus_list_metrics` — list all metric names with optional substring filter (cap 500)
+- `prometheus_query` — instant PromQL query with optional time parameter
+- `prometheus_query_range` — range PromQL query with time-series output (cap 5000 points)
+- `prometheus_list_alerts` — list active alerts grouped by state + severity
+- `prometheus_list_targets` — list scrape targets summarised by job + health
+- HTTP Basic auth and Bearer token auth support (Bearer takes precedence)
+- SSL verification toggle via `PROMETHEUS_SSL_VERIFY`
+- Thread-safe lazy client cache (double-checked locking)
+- Structured output (`outputSchema`) for all 5 tools via FastMCP `structured_output=True`
+- Markdown rendering with truncation hints for large result sets
+- Actionable error messages for 401/403/404/400/422/429/5xx/ConnectionError/Timeout

prometheus_mcp-0.1.0/Dockerfile

@@ -0,0 +1,8 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+# Install the package from PyPI
+RUN pip install --no-cache-dir prometheus-mcp
+
+ENTRYPOINT ["prometheus-mcp"]

prometheus_mcp-0.1.0/EVALUATION.md

@@ -0,0 +1,53 @@
+# Evaluation suite
+
+This repository ships a 10-question evaluation (`evaluation.xml`) built per the
+mcp-builder Phase 4 specification. The suite measures whether an LLM can
+productively use prometheus-mcp to answer realistic, read-only questions about
+metrics, alerts, and scrape targets.
+
+## Design principles
+
+Every question is **read-only, independent, stable, verifiable, complex, and
+instance-agnostic** — same principles as sonarqube-mcp's template. Since
+prometheus-mcp wraps a customer-owned Prometheus instance, no pre-solved answer
+shared fixture exists. The suite ships with `__VERIFY_ON_INSTANCE__` placeholders.
+
+## Filling in answers
+
+1. Pick a target Prometheus (self-hosted, or the public demo at https://demo.promlabs.com).
+2. Export env vars:
+   ```bash
+   export PROMETHEUS_URL=https://prometheus.example.com
+   # optional: export PROMETHEUS_TOKEN=... / PROMETHEUS_USERNAME / PROMETHEUS_PASSWORD
+   ```
+3. Solve each question manually — fastest path is to run Claude Code with this
+   MCP configured and ask the question verbatim.
+4. Replace the placeholder with the verified value.
+5. Narrow each question to target one specific entity for stability (e.g.
+   replace "first metric" with a specific metric name on your instance).
+
+## Running the harness
+
+```bash
+python scripts/evaluation.py \
+  -t stdio \
+  -c uvx \
+  -a prometheus-mcp \
+  -e PROMETHEUS_URL=$PROMETHEUS_URL \
+  -e PROMETHEUS_TOKEN=$PROMETHEUS_TOKEN \
+  -o evaluation_report.md \
+  evaluation.xml
+```
+
+Low-accuracy questions usually signal one of:
+
+- Tool description is ambiguous → tighten in `tools.py`.
+- Output schema is under/over-specified → adjust TypedDict in `models.py`.
+- Question itself is ambiguous on your instance → rephrase.
+
+## Design deviations
+
+Same honest compromise as sonarqube-mcp and jaeger-mcp: question *structure*
+is fixed (validates the MCP design), *values* come from whichever Prometheus
+you verify against. A shared fixture would require standing up a demo Prometheus
+with pinned metrics — out of scope for v0.1.0.

prometheus_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mikhail Shchegolev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

prometheus_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: prometheus-mcp
+Version: 0.1.0
+Summary: MCP server for Prometheus — query metrics, inspect alerts, and explore scrape targets (read-only).
+Project-URL: Homepage, https://github.com/mshegolev/prometheus-mcp
+Project-URL: Issues, https://github.com/mshegolev/prometheus-mcp/issues
+Author: Mikhail Shchegolev
+License: MIT
+License-File: LICENSE
+Keywords: anthropic,claude,mcp,metrics,monitoring,observability,prometheus,promql
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.2
+Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.31
+Requires-Dist: typing-extensions>=4.5; python_version < '3.12'
+Requires-Dist: urllib3>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: responses>=0.25; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# prometheus-mcp
+
+<!-- mcp-name: io.github.mshegolev/prometheus-mcp -->
+
+[![PyPI version](https://img.shields.io/pypi/v/prometheus-mcp.svg)](https://pypi.org/project/prometheus-mcp/)
+[![Python versions](https://img.shields.io/pypi/pyversions/prometheus-mcp.svg)](https://pypi.org/project/prometheus-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Tests](https://github.com/mshegolev/prometheus-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/mshegolev/prometheus-mcp/actions/workflows/test.yml)
+
+**MCP server for [Prometheus](https://prometheus.io/) metrics and observability.**
+Give Claude (or any MCP-capable agent) read access to your Prometheus instance — query metrics with PromQL, inspect active alerts, and explore scrape targets — without leaving the conversation.
+
+## Why another Prometheus MCP?
+
+The existing Prometheus integrations require custom scripts or direct API knowledge. This server:
+
+- Speaks the standard [Model Context Protocol](https://modelcontextprotocol.io/) over **stdio** — works with Claude Desktop, Claude Code, Cursor, and any MCP client.
+- Is **read-only**: all 5 tools carry `readOnlyHint: true` — zero risk of modifying Prometheus data.
+- Returns **dual-channel output**: structured JSON (`structuredContent`) for programmatic use + Markdown (`content`) for human-readable display.
+- Has **actionable error messages** that name the exact env var to fix and suggest a next step.
+- Supports **Bearer token**, **HTTP Basic auth**, or **no auth** (common for internal deployments).
+
+## Tools
+
+| Tool | Endpoint | Description |
+|------|----------|-------------|
+| `prometheus_list_metrics` | `GET /api/v1/label/__name__/values` | List all metric names with optional substring filter (cap 500) |
+| `prometheus_query` | `GET /api/v1/query` | Execute an instant PromQL query |
+| `prometheus_query_range` | `GET /api/v1/query_range` | Execute a PromQL range query returning time-series |
+| `prometheus_list_alerts` | `GET /api/v1/alerts` | List active and pending alerts |
+| `prometheus_list_targets` | `GET /api/v1/targets` | List scrape targets by health and job |
+
+## Installation
+
+```bash
+pip install prometheus-mcp
+```
+
+Or run directly without installing:
+
+```bash
+uvx prometheus-mcp
+```
+
+## Configuration
+
+All configuration is via environment variables:
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `PROMETHEUS_URL` | **Yes** | — | Prometheus server URL, e.g. `https://prometheus.example.com` (no trailing slash) |
+| `PROMETHEUS_TOKEN` | No | — | Bearer token (takes precedence over Basic auth) |
+| `PROMETHEUS_USERNAME` | No | — | HTTP Basic auth username |
+| `PROMETHEUS_PASSWORD` | No | — | HTTP Basic auth password |
+| `PROMETHEUS_SSL_VERIFY` | No | `true` | Set `false` for self-signed certificates |
+
+Copy `.env.example` to `.env` and fill in your values.
+
+## Claude Desktop / Claude Code setup
+
+Add to your MCP config (`claude_desktop_config.json` or `.claude/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "prometheus": {
+      "command": "prometheus-mcp",
+      "env": {
+        "PROMETHEUS_URL": "https://prometheus.example.com",
+        "PROMETHEUS_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+Or with `uvx` (no install required):
+
+```json
+{
+  "mcpServers": {
+    "prometheus": {
+      "command": "uvx",
+      "args": ["prometheus-mcp"],
+      "env": {
+        "PROMETHEUS_URL": "https://prometheus.example.com"
+      }
+    }
+  }
+}
+```
+
+## Docker
+
+```bash
+docker run --rm -e PROMETHEUS_URL=https://prometheus.example.com prometheus-mcp
+```
+
+## Example queries
+
+Once configured, ask Claude:
+
+- "What metrics does Prometheus have about HTTP requests?"
+- "What is the current request rate for the payment service?"
+- "Show me CPU usage over the last hour with 5-minute resolution"
+- "Are there any firing alerts? What's their severity?"
+- "Which scrape targets are currently down and why?"
+- "How many node-exporter instances are up?"
+
+## Tool usage guide
+
+### `prometheus_list_metrics`
+
+Returns all metric names Prometheus knows about. Use `pattern` to filter by substring (case-insensitive). **Start here** when you don't know which metrics are available. Output is capped at 500 metrics with a truncation hint.
+
+### `prometheus_query`
+
+Execute an instant PromQL expression and get current values. Returns result type (vector/scalar/matrix/string), sample count, and per-sample labels and values.
+
+Parameters:
+- `query` (required) — PromQL expression, e.g. `up`, `rate(http_requests_total[5m])`
+- `time` (optional) — RFC3339 or Unix timestamp; defaults to now
+
+### `prometheus_query_range`
+
+Execute a PromQL expression over a time window. Returns one series per matching time series with timestamped values. Total data points across all series are capped at 5000.
+
+Parameters:
+- `query` (required) — PromQL expression
+- `start` / `end` (required) — RFC3339 or Unix timestamps
+- `step` (required) — resolution like `15s`, `1m`, `5m`
+
+Prometheus rejects steps that would produce > 11,000 points per series (HTTP 422). Increase step or narrow the range if this happens.
+
+**Note:** The Prometheus range API does not support filtering by branch or commit — filters are expressed purely in PromQL label matchers.
+
+### `prometheus_list_alerts`
+
+Returns all active/pending alerts with labels (including `alertname`, `severity`), state, activation time, and current value. Includes a state summary (firing vs pending counts).
+
+### `prometheus_list_targets`
+
+Returns scrape targets with job name, instance address, health (`up`/`down`/`unknown`), last scrape duration in milliseconds, and any error message. Includes a per-job summary. Filter by `state`: `active` (default), `dropped`, or `any`.
+
+## Performance characteristics
+
+- All tools use a single persistent `requests.Session` with connection pooling.
+- The session has `trust_env = False` to bypass environment proxies (Prometheus is typically an internal service).
+- Requests time out after 30 seconds.
+- `prometheus_query_range` caps output at 5000 total points across all series — use a larger step for long windows.
+- `prometheus_list_metrics` returns up to 500 metrics after filtering.
+
+## Development
+
+```bash
+git clone https://github.com/mshegolev/prometheus-mcp
+cd prometheus-mcp
+pip install -e '.[dev]'
+pytest tests/ -v
+ruff check src tests
+ruff format src tests
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

prometheus_mcp-0.1.0/README.md

@@ -0,0 +1,166 @@
+# prometheus-mcp
+
+<!-- mcp-name: io.github.mshegolev/prometheus-mcp -->
+
+[![PyPI version](https://img.shields.io/pypi/v/prometheus-mcp.svg)](https://pypi.org/project/prometheus-mcp/)
+[![Python versions](https://img.shields.io/pypi/pyversions/prometheus-mcp.svg)](https://pypi.org/project/prometheus-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Tests](https://github.com/mshegolev/prometheus-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/mshegolev/prometheus-mcp/actions/workflows/test.yml)
+
+**MCP server for [Prometheus](https://prometheus.io/) metrics and observability.**
+Give Claude (or any MCP-capable agent) read access to your Prometheus instance — query metrics with PromQL, inspect active alerts, and explore scrape targets — without leaving the conversation.
+
+## Why another Prometheus MCP?
+
+The existing Prometheus integrations require custom scripts or direct API knowledge. This server:
+
+- Speaks the standard [Model Context Protocol](https://modelcontextprotocol.io/) over **stdio** — works with Claude Desktop, Claude Code, Cursor, and any MCP client.
+- Is **read-only**: all 5 tools carry `readOnlyHint: true` — zero risk of modifying Prometheus data.
+- Returns **dual-channel output**: structured JSON (`structuredContent`) for programmatic use + Markdown (`content`) for human-readable display.
+- Has **actionable error messages** that name the exact env var to fix and suggest a next step.
+- Supports **Bearer token**, **HTTP Basic auth**, or **no auth** (common for internal deployments).
+
+## Tools
+
+| Tool | Endpoint | Description |
+|------|----------|-------------|
+| `prometheus_list_metrics` | `GET /api/v1/label/__name__/values` | List all metric names with optional substring filter (cap 500) |
+| `prometheus_query` | `GET /api/v1/query` | Execute an instant PromQL query |
+| `prometheus_query_range` | `GET /api/v1/query_range` | Execute a PromQL range query returning time-series |
+| `prometheus_list_alerts` | `GET /api/v1/alerts` | List active and pending alerts |
+| `prometheus_list_targets` | `GET /api/v1/targets` | List scrape targets by health and job |
+
+## Installation
+
+```bash
+pip install prometheus-mcp
+```
+
+Or run directly without installing:
+
+```bash
+uvx prometheus-mcp
+```
+
+## Configuration
+
+All configuration is via environment variables:
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `PROMETHEUS_URL` | **Yes** | — | Prometheus server URL, e.g. `https://prometheus.example.com` (no trailing slash) |
+| `PROMETHEUS_TOKEN` | No | — | Bearer token (takes precedence over Basic auth) |
+| `PROMETHEUS_USERNAME` | No | — | HTTP Basic auth username |
+| `PROMETHEUS_PASSWORD` | No | — | HTTP Basic auth password |
+| `PROMETHEUS_SSL_VERIFY` | No | `true` | Set `false` for self-signed certificates |
+
+Copy `.env.example` to `.env` and fill in your values.
+
+## Claude Desktop / Claude Code setup
+
+Add to your MCP config (`claude_desktop_config.json` or `.claude/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "prometheus": {
+      "command": "prometheus-mcp",
+      "env": {
+        "PROMETHEUS_URL": "https://prometheus.example.com",
+        "PROMETHEUS_TOKEN": "your-token-here"
+      }
+    }
+  }
+}
+```
+
+Or with `uvx` (no install required):
+
+```json
+{
+  "mcpServers": {
+    "prometheus": {
+      "command": "uvx",
+      "args": ["prometheus-mcp"],
+      "env": {
+        "PROMETHEUS_URL": "https://prometheus.example.com"
+      }
+    }
+  }
+}
+```
+
+## Docker
+
+```bash
+docker run --rm -e PROMETHEUS_URL=https://prometheus.example.com prometheus-mcp
+```
+
+## Example queries
+
+Once configured, ask Claude:
+
+- "What metrics does Prometheus have about HTTP requests?"
+- "What is the current request rate for the payment service?"
+- "Show me CPU usage over the last hour with 5-minute resolution"
+- "Are there any firing alerts? What's their severity?"
+- "Which scrape targets are currently down and why?"
+- "How many node-exporter instances are up?"
+
+## Tool usage guide
+
+### `prometheus_list_metrics`
+
+Returns all metric names Prometheus knows about. Use `pattern` to filter by substring (case-insensitive). **Start here** when you don't know which metrics are available. Output is capped at 500 metrics with a truncation hint.
+
+### `prometheus_query`
+
+Execute an instant PromQL expression and get current values. Returns result type (vector/scalar/matrix/string), sample count, and per-sample labels and values.
+
+Parameters:
+- `query` (required) — PromQL expression, e.g. `up`, `rate(http_requests_total[5m])`
+- `time` (optional) — RFC3339 or Unix timestamp; defaults to now
+
+### `prometheus_query_range`
+
+Execute a PromQL expression over a time window. Returns one series per matching time series with timestamped values. Total data points across all series are capped at 5000.
+
+Parameters:
+- `query` (required) — PromQL expression
+- `start` / `end` (required) — RFC3339 or Unix timestamps
+- `step` (required) — resolution like `15s`, `1m`, `5m`
+
+Prometheus rejects steps that would produce > 11,000 points per series (HTTP 422). Increase step or narrow the range if this happens.
+
+**Note:** The Prometheus range API does not support filtering by branch or commit — filters are expressed purely in PromQL label matchers.
+
+### `prometheus_list_alerts`
+
+Returns all active/pending alerts with labels (including `alertname`, `severity`), state, activation time, and current value. Includes a state summary (firing vs pending counts).
+
+### `prometheus_list_targets`
+
+Returns scrape targets with job name, instance address, health (`up`/`down`/`unknown`), last scrape duration in milliseconds, and any error message. Includes a per-job summary. Filter by `state`: `active` (default), `dropped`, or `any`.
+
+## Performance characteristics
+
+- All tools use a single persistent `requests.Session` with connection pooling.
+- The session has `trust_env = False` to bypass environment proxies (Prometheus is typically an internal service).
+- Requests time out after 30 seconds.
+- `prometheus_query_range` caps output at 5000 total points across all series — use a larger step for long windows.
+- `prometheus_list_metrics` returns up to 500 metrics after filtering.
+
+## Development
+
+```bash
+git clone https://github.com/mshegolev/prometheus-mcp
+cd prometheus-mcp
+pip install -e '.[dev]'
+pytest tests/ -v
+ruff check src tests
+ruff format src tests
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).