MCP Victoriametrics
MCP Server for VictoriaMetrics. Provides integration with VictoriaMetrics API and…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.18.0
- Listing updated
- 4 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-community/mcp-victoriametrics:1.18.0Add 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-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
{
"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-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
{
"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-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
{
"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-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 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-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>"
}
}
}
}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)
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-community/mcp-victoriametrics:1.18.0