mcp

Overview ¶

Package mcp implements a Model Context Protocol (MCP) server that exposes promql-cli over stdio transport (JSON-RPC 2.0, protocol 2024-11-05).

Capabilities:

tools      — query_instant, query_range, list_metrics, list_labels,
             load_metrics, execute_line (with optional streaming)
resources  — promql://metrics, promql://metrics/list, promql://labels,
             and one promql://metrics/<name> per loaded metric
prompts    — parameterized PromQL templates (error-rate-by-service, etc.)
logging    — logging/setLevel to adjust slog verbosity at runtime
executionStreaming — execute_line stream=true support

Lifecycle methods: initialize, ping, shutdown, notifications/initialized.

Source layout:

mcp.go        — Server, transport framing, dispatch, lifecycle, logging
tools.go      — tool definitions, handlers, query execution, formatting
resources.go  — resources/list + resources/read
prompts.go    — prompts/list + prompts/get