Victoriametrics MCP Server

by victoriametrics-communityio.github.VictoriaMetrics-Community/mcp-victoriametricsv1.18.0

Integration with VictoriaMetrics instance APIs and documentation for monitoring, observability and debugging tasks.

237Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active9d ago

Install Victoriametrics MCP server

claude mcp add victoriametrics-victoriametrics-communit -e VM_INSTANCE_ENTRYPOINT='<vm-instance-entrypoint>' -e VM_INSTANCE_TYPE='<vm-instance-type>' -e VM_INSTANCE_BEARER_TOKEN='<vm-instance-bearer-token>' -e VMC_API_KEY='<vmc-api-key>' -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0

{
  "mcpServers": {
    "victoriametrics-victoriametrics-communit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "victoriametrics-victoriametrics-communit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "victoriametrics-victoriametrics-communit": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "victoriametrics-victoriametrics-communit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VM_INSTANCE_ENTRYPOINT",
        "-e",
        "VM_INSTANCE_TYPE",
        "-e",
        "VM_INSTANCE_BEARER_TOKEN",
        "-e",
        "VMC_API_KEY",
        "ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0"
      ],
      "env": {
        "VM_INSTANCE_ENTRYPOINT": "<vm-instance-entrypoint>",
        "VM_INSTANCE_TYPE": "<vm-instance-type>",
        "VM_INSTANCE_BEARER_TOKEN": "<vm-instance-bearer-token>",
        "VMC_API_KEY": "<vmc-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
VM_INSTANCE_ENTRYPOINT	yes	—	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	yes	—	Type of VictoriaMetrics instance (single / cluster)
VM_INSTANCE_BEARER_TOKEN	yes	yes	Authentication token for VictoriaMetrics API
VMC_API_KEY	—	yes	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)

Freshness

Active — last maintenance signal 9d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-30 · 9d ago · GitHub
Latest release
2026-04-15 · 6mo ago · GitHub · v1.20.2
Package published
no data · npm/PyPI
Registry entry updated
2025-12-15 · 10mo ago · official registry · v1.18.0

FAQ

›How do I install the Victoriametrics MCP server in Claude Code?

Run: claude mcp add victoriametrics-victoriametrics-communit -e VM_INSTANCE_ENTRYPOINT='<vm-instance-entrypoint>' -e VM_INSTANCE_TYPE='<vm-instance-type>' -e VM_INSTANCE_BEARER_TOKEN='<vm-instance-bearer-token>' -e VMC_API_KEY='<vmc-api-key>' -- docker run -i --rm -e VM_INSTANCE_ENTRYPOINT -e VM_INSTANCE_TYPE -e VM_INSTANCE_BEARER_TOKEN -e VMC_API_KEY ghcr.io/victoriametrics-community/mcp-victoriametrics:1.18.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Victoriametrics require an API key?

Yes. It expects VM_INSTANCE_ENTRYPOINT, VM_INSTANCE_TYPE, VM_INSTANCE_BEARER_TOKEN, VMC_API_KEY, of which 2 are secrets.

›Can I use Victoriametrics as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Victoriametrics in the official MCP registry?

Yes, as io.github.VictoriaMetrics-Community/mcp-victoriametrics.