Home › Cloud & Monitoring › mcp-victoriametrics

mcp-victoriametrics

MCP Server for VictoriaMetrics. Provides integration with VictoriaMetrics API and documentation

Official Go Local

★ 234 stars Last pushed 2026-08-23 License: Apache-2.0

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (oci)

docker run -i --rm ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1

Or add to your MCP client config:

{
  "mcpServers": {
    "mcp-victoriametrics": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/victoriametrics/mcp-victoriametrics:1.120.1"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<YOUR_VALUE>",
        "VM_INSTANCE_TYPE": "<YOUR_VALUE>",
        "VM_INSTANCE_BEARER_TOKEN": "<YOUR_VALUE>",
        "VMC_API_KEY": "<YOUR_VALUE>",
        "MCP_DISABLED_TOOLS": "<YOUR_VALUE>",
        "MCP_DISABLE_RESOURCES": "<YOUR_VALUE>",
        "MCP_PASSTHROUGH_HEADERS": "<YOUR_VALUE>"
      }
    }
  }
}

VM_INSTANCE_ENTRYPOINT required — URL to VictoriaMetrics instance (it should be root URL of vmsingle or vmselect), for example http://localhost:8428 or https://play.victoriametrics.com
VM_INSTANCE_TYPE required — Type of VictoriaMetrics instance (single / cluster)
VM_INSTANCE_BEARER_TOKEN required secret — Authentication token for VictoriaMetrics API
VMC_API_KEY secret — Optional: API key from VictoriaMetrics Cloud Console (if you have deployment in VictoriaMetrics Cloud)
MCP_DISABLED_TOOLS — Comma-separated list of tools to disable
MCP_DISABLE_RESOURCES — Disable all resources (documentation tool will continue to work)
MCP_PASSTHROUGH_HEADERS — HTTP header names to forward from incoming MCP requests to VictoriaMetrics (comma-separated list). Overrides VM_INSTANCE_HEADERS on collision.