mcp-victoriametrics

Overview

The VictoriaMetrics MCP server allows seamless integration with VictoriaMetrics APIs and provides comprehensive access to monitoring, observability, and debugging capabilities. It supports nearly all read-only APIs of VictoriaMetrics, including querying metrics, listing and exporting data, analyzing alerting rules, and exploring query patterns. The server includes embedded documentation and can search it offline, making it valuable for DevOps teams and engineers working with monitoring data.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• query

  Query metrics and explore data from VictoriaMetrics

  Try:Show me the CPU usage for the last hourTry:Get memory usage metrics for the last 24 hours
• list_metrics

  List all available metrics in the VictoriaMetrics instance

  Try:List all available metricsTry:Show me all metrics related to disk usage
• list_labels

  List all available labels in the VictoriaMetrics instance

  Try:List all available labelsTry:Show me all labels for the 'cpu' metric
• list_label_values

  List all values for a specific label

  Try:List values for the 'instance' labelTry:Show me all values for the 'job' label
• list_series

  List all time series data matching a label selector

  Try:List all series for the 'cpu' metricTry:Show me all series with the 'instance' label
• test_rules

  Test alerting and recording rules

  Try:Test my alert rules for high CPU usageTry:Validate my recording rules
• instance_params

  Show parameters of the VictoriaMetrics instance

  Try:Show me VictoriaMetrics configuration parametersTry:What are the current settings of this instance?
• cardinality_stats

  Show cardinality statistics for metrics

  Try:Show cardinality statisticsTry:What's the cardinality of the 'cpu' metric?
• query_explain

  Explain a VictoriaMetrics query

  Try:Explain this query: sum(rate(cpu_usage[5m]))Try:Analyze the performance of my metric query
• metric_relabel_debug

  Debug metric relabeling rules

  Try:Debug my metric relabeling rulesTry:Show me what relabeling rules are applied
• export

  Export metrics data

  Try:Export CPU metrics to CSVTry:Download memory usage data for the last day
• search_docs

  Search VictoriaMetrics documentation

  Try:How to configure retention policy?Try:Look up information about downsampling

Comparable tools

Installation

"mcpServers": {
  "victoriametrics": {
    "command": "path/to/mcp-victoriametrics",
    "args": ["-m", "sse", "-e", "https://your.victoriametrics.instance"]
  }
}

FAQ

What types of VictoriaMetrics APIs does this server support?

The server supports almost all read-only APIs of VictoriaMetrics, including querying metrics, listing and exporting available metrics/labels/values, analyzing alerting rules, showing instance parameters, exploring cardinality, debugging queries and relabeling rules, and integration with VictoriaMetrics Cloud.

Can I use this MCP server with VictoriaMetrics Cloud?

Yes, you can configure the server to work with VictoriaMetrics Cloud either by setting the VM_INSTANCE_ENTRYPOINT to your cloud endpoint or by using the VMC_API_KEY environment variable with your cloud API key.

Compare mcp-victoriametrics with