mcp-victoriatraces — MCP-сервер для Claude Code: трассировки
Даёт ИИ-агенту доступ к VictoriaTraces: он может искать сервисы и операции, запрашивать трассировки и находить ответы во встроенной документации. Пригодится для разбора данных трассировки и отладки.
claude mcp add --env VT_INSTANCE_ENTRYPOINT=<VT_INSTANCE_ENTRYPOINT> --env VT_INSTANCE_BEARER_TOKEN=<VT_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> --transport stdio mcp-victoriatraces -- docker run -i --rm -e VT_INSTANCE_ENTRYPOINT -e VT_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0Что делает mcp-victoriatraces
MCP-сервер подключается к экземпляру VictoriaTraces и предоставляет инструменты для чтения данных: поиска сервисов и операций, а также запросов и анализа трассировок. Документация VictoriaTraces встроена в сервер, поэтому её можно искать без доступа к сети.
Для работы нужен экземпляр VictoriaTraces. Адрес задаётся через VT_INSTANCE_ENTRYPOINT; для API можно передать токен в VT_INSTANCE_BEARER_TOKEN. Для Claude Code в примере установки используется Docker. Качество ответов зависит от возможностей клиента и модели, так что при разборе трассировок это стоит учитывать.
Какие задачи решает
- найти доступные сервисы VictoriaTraces
- получить список операций и имён спанов
- запросить и исследовать трассировки
- найти сведения в документации VictoriaTraces без сети
Примеры запросов агенту
- Найди сервисы и операции в моём экземпляре VictoriaTraces.
- Запроси трассировки для сервиса и помоги разобрать результаты.
- Найди в документации VictoriaTraces, как запросить трассировки.
Как установить mcp-victoriatraces
Командой платформы
claude mcp add --env VT_INSTANCE_ENTRYPOINT=<VT_INSTANCE_ENTRYPOINT> --env VT_INSTANCE_BEARER_TOKEN=<VT_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> --transport stdio mcp-victoriatraces -- docker run -i --rm -e VT_INSTANCE_ENTRYPOINT -e VT_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0Вместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-victoriatraces --env VT_INSTANCE_ENTRYPOINT=<VT_INSTANCE_ENTRYPOINT> --env VT_INSTANCE_BEARER_TOKEN=<VT_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> -- docker run -i --rm -e VT_INSTANCE_ENTRYPOINT -e VT_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-victoriatraces": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VT_INSTANCE_ENTRYPOINT",
"-e",
"VT_INSTANCE_BEARER_TOKEN",
"-e",
"MCP_DISABLED_TOOLS",
"ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0"
],
"env": {
"VT_INSTANCE_ENTRYPOINT": "<VT_INSTANCE_ENTRYPOINT>",
"VT_INSTANCE_BEARER_TOKEN": "<VT_INSTANCE_BEARER_TOKEN>",
"MCP_DISABLED_TOOLS": "<MCP_DISABLED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-victoriatraces": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"VT_INSTANCE_ENTRYPOINT",
"-e",
"VT_INSTANCE_BEARER_TOKEN",
"-e",
"MCP_DISABLED_TOOLS",
"ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0"
],
"env": {
"VT_INSTANCE_ENTRYPOINT": "<VT_INSTANCE_ENTRYPOINT>",
"VT_INSTANCE_BEARER_TOKEN": "<VT_INSTANCE_BEARER_TOKEN>",
"MCP_DISABLED_TOOLS": "<MCP_DISABLED_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e VT_INSTANCE_ENTRYPOINT=<VT_INSTANCE_ENTRYPOINT> -e VT_INSTANCE_BEARER_TOKEN=<VT_INSTANCE_BEARER_TOKEN> -e MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> mcp-victoriatraces docker run -i --rm -e VT_INSTANCE_ENTRYPOINT -e VT_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-victoriatraces
Как установить mcp-victoriatraces в Claude Code?
Выполните команду: `claude mcp add --env VT_INSTANCE_ENTRYPOINT=<VT_INSTANCE_ENTRYPOINT> --env VT_INSTANCE_BEARER_TOKEN=<VT_INSTANCE_BEARER_TOKEN> --env MCP_DISABLED_TOOLS=<MCP_DISABLED_TOOLS> --transport stdio mcp-victoriatraces -- docker run -i --rm -e VT_INSTANCE_ENTRYPOINT -e VT_INSTANCE_BEARER_TOKEN -e MCP_DISABLED_TOOLS ghcr.io/victoriametrics-community/mcp-victoriatraces:1.5.0. Укажите адрес экземпляра VictoriaTraces в VT_INSTANCE_ENTRYPOINT`.
Что делает mcp-victoriatraces?
Подключает ИИ-клиент к VictoriaTraces и даёт инструменты для поиска сервисов и операций, а также запросов и анализа трассировок. Встроенную документацию можно искать без сети.
Нужен ли токен для работы mcp-victoriatraces?
Нужен адрес VictoriaTraces в VT_INSTANCE_ENTRYPOINT. Токен API передаётся через VT_INSTANCE_BEARER_TOKEN, но он указан как необязательная настройка.
