io.github.VictoriaMetrics/mcp-victoriametrics

Name: io.github.VictoriaMetrics/mcp-victoriametrics
Author: VictoriaMetrics

MCP

by VictoriaMetrics · v1.120.1

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

mcplocal

MCP configuration

stdio

Command

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

Environment

VM_INSTANCE_ENTRYPOINTrequired
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_TYPErequired
Type of VictoriaMetrics instance (single / cluster)
VM_INSTANCE_BEARER_TOKENrequiredsecret
Authentication token for VictoriaMetrics API
VMC_API_KEYsecret
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.

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.