Victoriatraces MCP Server
by victoriametrics-communityio.github.VictoriaMetrics-Community/mcp-victoriatracesv1.5.0
MCP Server for VictoriaTraces. Provides integration with VictoriaTraces API and documentation
context tax
queued
security
queued
cold start
queued
freshness
Active10d ago
Install Victoriatraces MCP server
Install in Claude Code
claude mcp add victoriatraces -e VT_INSTANCE_ENTRYPOINT='<vt-instance-entrypoint>' -e 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.0Install in Cursor
{
"mcpServers": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"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>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"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 .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"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 ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| VT_INSTANCE_ENTRYPOINT | yes | — | URL to VictoriaTraces instance (it should be root URL of vtlingle or vtselect), for example http://localhost:10428 |
| VT_INSTANCE_BEARER_TOKEN | yes | yes | Authentication token for VictoriaMetrics API |
| MCP_DISABLED_TOOLS | — | — | Comma-separated list of tools to disable |
Freshness
Active — last maintenance signal 10d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-30 · 10d ago · GitHub
Latest release
2025-12-15 · 10mo ago · GitHub · v1.5.0
Package published
no data · npm/PyPI
Registry entry updated
2025-12-15 · 10mo ago · official registry · v1.5.0
FAQ
›How do I install the Victoriatraces MCP server in Claude Code?
Run: claude mcp add victoriatraces -e VT_INSTANCE_ENTRYPOINT='<vt-instance-entrypoint>' -e 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. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Victoriatraces require an API key?
Yes. It expects VT_INSTANCE_ENTRYPOINT, VT_INSTANCE_BEARER_TOKEN, of which 1 is a secret.
›Can I use Victoriatraces as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Victoriatraces in the official MCP registry?
Yes, as io.github.VictoriaMetrics-Community/mcp-victoriatraces.
Alternatives to Victoriatraces
Other documentation MCP servers.
Context7ActiveContext7 MCP - Up-to-date Docs For Any Cursor Prompt
Context7ActiveUp-to-date code documentation for LLMs and AI code editors.
DocsActiveProvides AI assistants with direct access to Mastra.ai's complete knowledge base.
AWS DocumentationActiveFetch, convert, and search AWS documentation pages, with recommendations for related content.
GitSlowingGeneric remote server that provides documentation for any GitHub repository or project.
Sui Knowledge Base (kapa.ai)ActiveSemantic search across Sui documentation and knowledge sources, powered by kapa.ai