用途：通过 Prometheus 的 HTTP API（基础路径 /api/v1）查询监控数据，适合让 Claude 执行 PromQL 查询、检索指标与告警状态。
主要能力：提供即时查询 /api/v1/query 与范围查询 /api/v1/query_range，支持 PromQL 格式化、按标签查序列、列出标签名与标签值、查询 exemplars；还可读取元数据与状态，包括 targets、targets/metadata、metadata、rules、alerts、alertmanagers、status/config、status/flags、status/runtimeinfo、status/buildinfo、status/tsdb、status/walreplay。管理类接口（需 --web.enable-admin-api）可创建 TSDB 快照、删除序列、清理墓碑数据。返回均为 JSON，含 status、data、errorType、error、warnings，HTTP 状态码 400、422、503 分别对应参数错误、表达式错误、超时。
使用方式：即时查询示例 curl 'http://<prometheus>:9090/api/v1/query?query=<promql>&time=<timestamp>'，范围查询用 /api/v1/query_range 并提供 start、end、step。附带脚本：python scripts/prom_query.py http://localhost:9090 'up'，范围查询加 --start、--end、--step，输出可用 --format table/json/csv；健康检查用 python scripts/prom_health.py http://localhost:9090。详细文档见 references/api_reference.md 与 references/promql_functions.md。
适用场景：查询指标、排查目标状态、检查告警规则与活跃告警、查看配置与 TSDB 基数等。
限制与注意事项：rate() 在计数器频繁重置时结果无意义；up{} 目标抖动为 0 不一定触发告警，取决于 for；记录规则错过的评估不会回填；联邦 match[] 需全部匹配，空匹配返回空序列；序列停止抓取后默认 5 分钟出现 stale 标记，查询显示 no data 而非 0；relabel 的 keep 正则在错误时会静默丢弃目标，需用 /api/v1/targets 验证。管理接口默认不可用。