VictoriaMetrics

VictoriaMetrics

MCP server enabling read-only VictoriaMetrics APIs with embedded documentation and interactive prompts.

91
Stars
12
Forks
20
Releases

Overview

VictoriaMetrics MCP Server is an MCP implementation that provides access to a VictoriaMetrics instance through read-only APIs and integrated documentation. It delivers a seamless interface to VictoriaMetrics APIs and documentation, enabling monitoring, observability, and debugging tasks for engineers and automation tools. The server exposes almost all read-only VMUI functionality: query and explore metrics, list and export metrics, labels, values and time series, analyze alerting and recording rules, and view instance parameters. It also supports exploring data cardinality and usage statistics, and stepping through, tracing, prettifying and explaining queries. In addition, it includes tooling to debug relabeling rules, downsampling and retention policy configurations. The MCP server can be configured to operate in stdio, SSE, or HTTP mode, with endpoints like /sse, /message, /mcp, /metrics and health checks. It ships with embedded up-to-date VictoriaMetrics documentation searchable offline, offers Cloud integration via VMC API keys, and includes configuration options to control tools, heartbeats, and request headers. The project provides sample prompts and a dialog example to illustrate how to combine tooling, docs search and dialogs in practical use.

Details

Owner
VictoriaMetrics-Community
Language
Go
License
Apache License 2.0
Updated
2025-12-07

Features

Read-only access to VMUI via MCP

Provides access to almost all read-only VictoriaMetrics VMUI APIs through MCP, enabling metrics querying and data exploration.

Metrics discovery and export

List and export metrics, labels, label values and entire series.

Query analysis and explain/prettify

Analyze, trace, prettify and explain queries (PromQL/MetricsQL) to understand performance and behavior.

Alerts and rules debugging

Analyze, test and debug alerting and recording rules, and view current alerts.

Parameters, cardinality and usage statistics

Show VictoriaMetrics parameters, explore data cardinality and metrics usage statistics.

Relabeling and downsampling debugging

Debug Prometheus relabeling rules and downsampling configurations, including retention policy settings.

Cloud integration

Supports integration with VictoriaMetrics Cloud via API keys.

Embedded offline documentation search

Contains embedded up-to-date VictoriaMetrics documentation searchable without online access.

Audience

EngineersUse MCP VictoriaMetrics to monitor, debug, and automate tasks across deployments.
DevelopersExplore APIs and embedded docs to prototype prompts and tests quickly.
OperationsOps teams diagnose performance and configuration with built-in tools and dashboards.
Data scientistsData scientists can experiment with queries and visualizations to derive insights.

Tags

VictoriaMetricsMCPVMUImonitoringobservabilitydebuggingClouddocumentationdownsamplingrelabelingPrometheusembedded-docs