MCP Victoriametrics
MCP Server for VictoriaMetrics. Provides integration with VictoriaMetrics API and…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.120.1
- Listing updated
- 5 days ago
About MCP Victoriametrics
MCP Victoriametrics is an open-source MCP server. It runs locally on your machine and is started by your AI client.
MCP Server for VictoriaMetrics. Provides integration with VictoriaMetrics API and documentation
Install
Run in a terminal
claude mcp add mcp-victoriametrics --env VM_INSTANCE_ENTRYPOINT='<VM_INSTANCE_ENTRYPOINT>' --env VM_INSTANCE_TYPE='<VM_INSTANCE_TYPE>' --env VM_INSTANCE_BEARER_TOKEN='<VM_INSTANCE_BEARER_TOKEN>' --env 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/mcp-victoriametrics:1.120.1Add to claude_desktop_config.json
{
"mcpServers": {
"mcp-victoriametrics": {
"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/mcp-victoriametrics:1.120.1"
],
"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
{
"mcpServers": {
"mcp-victoriametrics": {
"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/mcp-victoriametrics:1.120.1"
],
"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
{
"servers": {
"mcp-victoriametrics": {
"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/mcp-victoriametrics:1.120.1"
],
"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
{
"mcpServers": {
"mcp-victoriametrics": {
"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/mcp-victoriametrics:1.120.1"
],
"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 your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-victoriametrics": {
"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/mcp-victoriametrics:1.120.1"
],
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
VM_INSTANCE_ENTRYPOINTURL to VictoriaMetrics instance (it should be root URL of vmsingle or vmselect), for example http://localhost:8428 or https://play.victoriametrics.comRequiredVM_INSTANCE_TYPEType of VictoriaMetrics instance (single / cluster)RequiredVM_INSTANCE_BEARER_TOKENAuthentication token for VictoriaMetrics APIRequiredVMC_API_KEYOptional: API key from VictoriaMetrics Cloud Console (if you have deployment in VictoriaMetrics Cloud)MCP_DISABLED_TOOLSComma-separated list of tools to disableMCP_DISABLE_RESOURCESDisable all resources (documentation tool will continue to work)MCP_PASSTHROUGH_HEADERSHTTP header names to forward from incoming MCP requests to VictoriaMetrics (comma-separated list). Overrides VM_INSTANCE_HEADERS on collision.
Pricing
Open source
MCP Victoriametrics FAQ
Is MCP Victoriametrics free?
Yes. MCP Victoriametrics is open source, so you can use and self-host it for free.
How do I add MCP Victoriametrics to Claude Code?
Run this command in your terminal: claude mcp add mcp-victoriametrics --env VM_INSTANCE_ENTRYPOINT='<VM_INSTANCE_ENTRYPOINT>' --env VM_INSTANCE_TYPE='<VM_INSTANCE_TYPE>' --env VM_INSTANCE_BEARER_TOKEN='<VM_INSTANCE_BEARER_TOKEN>' --env 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/mcp-victoriametrics:1.120.1
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.