Active
VictoriaMetrics-Community/mcp-victoriametrics
The implementation of Model Context Protocol (MCP) server for VictoriaMetrics
Install this MCP
Pick your client, then copy the config.
{
"mcpServers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}{
"mcpServers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}{
"servers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}{
"mcpServers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}# Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.victoriametrics] command = "docker" args = ["run", "-i", "--rm", "-e", "VM_INSTANCE_ENTRYPOINT", "-e", "VM_INSTANCE_TYPE", "-e", "VM_INSTANCE_BEARER_TOKEN", "-e", "VM_INSTANCE_HEADERS", "ghcr.io/victoriametrics/mcp-victoriametrics"] [mcp_servers.victoriametrics.env] VM_INSTANCE_ENTRYPOINT = "YOUR_VM_INSTANCE" VM_INSTANCE_TYPE = "YOUR_VM_INSTANCE_TYPE" VM_INSTANCE_BEARER_TOKEN = "YOUR_VM_BEARER_TOKEN" VM_INSTANCE_HEADERS = "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
Set up with your agent
Uses the same client as above (Cursor). Paste into that agent.
Install the "VictoriaMetrics-Community/mcp-victoriametrics" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victoriametrics
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VM_INSTANCE_ENTRYPOINT (required): See repository README.
- VM_INSTANCE_TYPE (required): See repository README.
- VM_INSTANCE_BEARER_TOKEN (required): See repository README.
- VM_INSTANCE_HEADERS (required): See repository README.
4. Restart Cursor if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/victoriametrics.htmlInstall the "VictoriaMetrics-Community/mcp-victoriametrics" MCP for Claude Desktop in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victoriametrics
2. Merge this JSON into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VM_INSTANCE_ENTRYPOINT (required): See repository README.
- VM_INSTANCE_TYPE (required): See repository README.
- VM_INSTANCE_BEARER_TOKEN (required): See repository README.
- VM_INSTANCE_HEADERS (required): See repository README.
4. Restart Claude Desktop if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/victoriametrics.htmlInstall the "VictoriaMetrics-Community/mcp-victoriametrics" MCP for VS Code in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victoriametrics
2. Merge this JSON into .vscode/mcp.json:
{
"servers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VM_INSTANCE_ENTRYPOINT (required): See repository README.
- VM_INSTANCE_TYPE (required): See repository README.
- VM_INSTANCE_BEARER_TOKEN (required): See repository README.
- VM_INSTANCE_HEADERS (required): See repository README.
4. Restart VS Code if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/victoriametrics.htmlInstall the "VictoriaMetrics-Community/mcp-victoriametrics" MCP for Windsurf in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victoriametrics
2. Merge this JSON into ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"victoriametrics": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VM_INSTANCE_ENTRYPOINT",
"-e",
"VM_INSTANCE_TYPE",
"-e",
"VM_INSTANCE_BEARER_TOKEN",
"-e",
"VM_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victoriametrics"
],
"env": {
"VM_INSTANCE_ENTRYPOINT": "YOUR_VM_INSTANCE",
"VM_INSTANCE_TYPE": "YOUR_VM_INSTANCE_TYPE",
"VM_INSTANCE_BEARER_TOKEN": "YOUR_VM_BEARER_TOKEN",
"VM_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VM_INSTANCE_ENTRYPOINT (required): See repository README.
- VM_INSTANCE_TYPE (required): See repository README.
- VM_INSTANCE_BEARER_TOKEN (required): See repository README.
- VM_INSTANCE_HEADERS (required): See repository README.
4. Restart Windsurf if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/victoriametrics.htmlInstall the "VictoriaMetrics-Community/mcp-victoriametrics" MCP for Codex in this workspace. 1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victoriametrics 2. Merge this TOML under [mcp_servers.*] into ~/.codex/config.toml (or .codex/config.toml in a trusted project): # Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.victoriametrics] command = "docker" args = ["run", "-i", "--rm", "-e", "VM_INSTANCE_ENTRYPOINT", "-e", "VM_INSTANCE_TYPE", "-e", "VM_INSTANCE_BEARER_TOKEN", "-e", "VM_INSTANCE_HEADERS", "ghcr.io/victoriametrics/mcp-victoriametrics"] [mcp_servers.victoriametrics.env] VM_INSTANCE_ENTRYPOINT = "YOUR_VM_INSTANCE" VM_INSTANCE_TYPE = "YOUR_VM_INSTANCE_TYPE" VM_INSTANCE_BEARER_TOKEN = "YOUR_VM_BEARER_TOKEN" VM_INSTANCE_HEADERS = "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>" 3. Required environment variables / secrets (ask the user; never invent secrets): - VM_INSTANCE_ENTRYPOINT (required): See repository README. - VM_INSTANCE_TYPE (required): See repository README. - VM_INSTANCE_BEARER_TOKEN (required): See repository README. - VM_INSTANCE_HEADERS (required): See repository README. 4. Restart Codex if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets. Catalog: https://averlo.xyz/launches/victoriametrics.html
Try it
After install, paste one of these into your agent.
- Show me what VictoriaMetrics-Community/mcp-victoriametrics can do
- Set up a simple workflow using VictoriaMetrics-Community/mcp-victoriametrics
- List the tools available in VictoriaMetrics-Community/mcp-victoriametrics
