Maintained
VictoriaMetrics-Community/mcp-victorialogs
The implementation of Model Context Protocol (MCP) server for VictoriaLogs.
Install this MCP
Pick your client, then copy the config.
{
"mcpServers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}{
"mcpServers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}{
"servers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}{
"mcpServers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}# Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.victorialogs] command = "docker" args = ["run", "-i", "--rm", "-e", "VL_INSTANCE_ENTRYPOINT", "-e", "VL_INSTANCE_BEARER_TOKEN", "-e", "VL_INSTANCE_HEADERS", "ghcr.io/victoriametrics/mcp-victorialogs"] [mcp_servers.victorialogs.env] VL_INSTANCE_ENTRYPOINT = "YOUR_VL_INSTANCE" VL_INSTANCE_BEARER_TOKEN = "YOUR_VL_BEARER_TOKEN" VL_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-victorialogs" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victorialogs
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VL_INSTANCE_ENTRYPOINT (required): See repository README.
- VL_INSTANCE_BEARER_TOKEN (required): See repository README.
- VL_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/victorialogs.htmlInstall the "VictoriaMetrics-Community/mcp-victorialogs" MCP for Claude Desktop in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victorialogs
2. Merge this JSON into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VL_INSTANCE_ENTRYPOINT (required): See repository README.
- VL_INSTANCE_BEARER_TOKEN (required): See repository README.
- VL_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/victorialogs.htmlInstall the "VictoriaMetrics-Community/mcp-victorialogs" MCP for VS Code in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victorialogs
2. Merge this JSON into .vscode/mcp.json:
{
"servers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VL_INSTANCE_ENTRYPOINT (required): See repository README.
- VL_INSTANCE_BEARER_TOKEN (required): See repository README.
- VL_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/victorialogs.htmlInstall the "VictoriaMetrics-Community/mcp-victorialogs" MCP for Windsurf in this workspace.
1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victorialogs
2. Merge this JSON into ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"victorialogs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VL_INSTANCE_ENTRYPOINT",
"-e",
"VL_INSTANCE_BEARER_TOKEN",
"-e",
"VL_INSTANCE_HEADERS",
"ghcr.io/victoriametrics/mcp-victorialogs"
],
"env": {
"VL_INSTANCE_ENTRYPOINT": "YOUR_VL_INSTANCE",
"VL_INSTANCE_BEARER_TOKEN": "YOUR_VL_BEARER_TOKEN",
"VL_INSTANCE_HEADERS": "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- VL_INSTANCE_ENTRYPOINT (required): See repository README.
- VL_INSTANCE_BEARER_TOKEN (required): See repository README.
- VL_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/victorialogs.htmlInstall the "VictoriaMetrics-Community/mcp-victorialogs" MCP for Codex in this workspace. 1. Read official install docs: https://github.com/VictoriaMetrics/mcp-victorialogs 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.victorialogs] command = "docker" args = ["run", "-i", "--rm", "-e", "VL_INSTANCE_ENTRYPOINT", "-e", "VL_INSTANCE_BEARER_TOKEN", "-e", "VL_INSTANCE_HEADERS", "ghcr.io/victoriametrics/mcp-victorialogs"] [mcp_servers.victorialogs.env] VL_INSTANCE_ENTRYPOINT = "YOUR_VL_INSTANCE" VL_INSTANCE_BEARER_TOKEN = "YOUR_VL_BEARER_TOKEN" VL_INSTANCE_HEADERS = "<HEADER>=<HEADER_VALUE>,<HEADER>=<HEADER_VALUE>" 3. Required environment variables / secrets (ask the user; never invent secrets): - VL_INSTANCE_ENTRYPOINT (required): See repository README. - VL_INSTANCE_BEARER_TOKEN (required): See repository README. - VL_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/victorialogs.html
Try it
After install, paste one of these into your agent.
- Show me what VictoriaMetrics-Community/mcp-victorialogs can do
- Set up a simple workflow using VictoriaMetrics-Community/mcp-victorialogs
- List the tools available in VictoriaMetrics-Community/mcp-victorialogs

