Skip to content
MCP server

MCP Victoriatraces

MCP Server for VictoriaTraces. Provides integration with VictoriaTraces API and…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.5.0
Listing updated
4 days ago

About MCP Victoriatraces

MCP Victoriatraces is an open-source MCP server. It runs locally on your machine and is started by your AI client.

MCP Server for VictoriaTraces. Provides integration with VictoriaTraces API and documentation

Install

Run in a terminal

claude mcp add mcp-victoriatraces --env VT_INSTANCE_ENTRYPOINT='<VT_INSTANCE_ENTRYPOINT>' --env VT_INSTANCE_BEARER_TOKEN='<VT_INSTANCE_BEARER_TOKEN>' -- docker run -i --rm -e VT_INSTANCE_ENTRYPOINT -e VT_INSTANCE_BEARER_TOKEN ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-victoriatraces": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VT_INSTANCE_ENTRYPOINT",
        "-e",
        "VT_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0"
      ],
      "env": {
        "VT_INSTANCE_ENTRYPOINT": "<VT_INSTANCE_ENTRYPOINT>",
        "VT_INSTANCE_BEARER_TOKEN": "<VT_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-victoriatraces": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VT_INSTANCE_ENTRYPOINT",
        "-e",
        "VT_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0"
      ],
      "env": {
        "VT_INSTANCE_ENTRYPOINT": "<VT_INSTANCE_ENTRYPOINT>",
        "VT_INSTANCE_BEARER_TOKEN": "<VT_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-victoriatraces": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VT_INSTANCE_ENTRYPOINT",
        "-e",
        "VT_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0"
      ],
      "env": {
        "VT_INSTANCE_ENTRYPOINT": "<VT_INSTANCE_ENTRYPOINT>",
        "VT_INSTANCE_BEARER_TOKEN": "<VT_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-victoriatraces": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VT_INSTANCE_ENTRYPOINT",
        "-e",
        "VT_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0"
      ],
      "env": {
        "VT_INSTANCE_ENTRYPOINT": "<VT_INSTANCE_ENTRYPOINT>",
        "VT_INSTANCE_BEARER_TOKEN": "<VT_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-victoriatraces": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VT_INSTANCE_ENTRYPOINT",
        "-e",
        "VT_INSTANCE_BEARER_TOKEN",
        "ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0"
      ],
      "env": {
        "VT_INSTANCE_ENTRYPOINT": "<VT_INSTANCE_ENTRYPOINT>",
        "VT_INSTANCE_BEARER_TOKEN": "<VT_INSTANCE_BEARER_TOKEN>"
      }
    }
  }
}

Configuration

  • VT_INSTANCE_ENTRYPOINTURL to VictoriaTraces instance (it should be root URL of vtlingle or vtselect), for example http://localhost:10428Required
  • VT_INSTANCE_BEARER_TOKENAuthentication token for VictoriaMetrics APIRequired
  • MCP_DISABLED_TOOLSComma-separated list of tools to disable

Pricing

Open source

MCP Victoriatraces FAQ

Is MCP Victoriatraces free?

Yes. MCP Victoriatraces is open source, so you can use and self-host it for free.

How do I add MCP Victoriatraces to Claude Code?

Run this command in your terminal: claude mcp add mcp-victoriatraces --env VT_INSTANCE_ENTRYPOINT='<VT_INSTANCE_ENTRYPOINT>' --env VT_INSTANCE_BEARER_TOKEN='<VT_INSTANCE_BEARER_TOKEN>' -- docker run -i --rm -e VT_INSTANCE_ENTRYPOINT -e VT_INSTANCE_BEARER_TOKEN ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0