VictoriaMetrics MCP

What it does

This server provides a comprehensive interface for monitoring, observability, and debugging tasks related to VictoriaMetrics instances. It allows AI assistants to execute PromQL/MetricsQL queries, explore available metrics, and analyze alerting rules.

Tools

• query: Execute instant PromQL/MetricsQL queries.
• query_range: Execute range queries over a time period.
• metrics: List available metrics in the system.
• labels: List available label names.
• alerts: View current firing and pending alerts.
• tsdb_status: View TSDB cardinality statistics.
• documentation: Search embedded VictoriaMetrics documentation.

Installation

Download the binary from the releases page and add it to your PATH.

Configure Claude Desktop in claude_desktop_config.json:

{
  "mcpServers": {
    "victoriametrics": {
      "command": "/path/to/mcp-victoriametrics",
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VM_INSTANCE>",
        "VM_INSTANCE_TYPE": "<YOUR_VM_INSTANCE_TYPE>"
      }
    }
  }
}

Supported hosts

• claude
• cursor
• codex
• zed
• windsurf