Сервер MCP VictoriaLogs

Name: mcp-victorialogs
Author: VictoriaMetrics-Community

Последний релиз значок кузнеца Лицензия Слак Реддит

Реализация сервера Model Context Protocol (MCP) для VictoriaLogs .

Это обеспечивает доступ к вашему экземпляру VictoriaLogs и бесшовную интеграцию с API VictoriaLogs и документацией . Это может предоставить вам комплексный интерфейс для журналов, наблюдения и задач отладки, связанных с вашими экземплярами VictoriaLogs, включить расширенные возможности автоматизации и взаимодействия для инженеров и инструментов.

Функции

Этот сервер MCP позволяет использовать почти все API VictoriaLogs, доступные только для чтения, т. е. все функции, доступные в веб-интерфейсе :

Запрос журналов и изучение данных журналов
Отображение параметров вашего экземпляра VictoriaLogs
Список доступных потоков, полей, значений полей
Запрос статистики для журналов в качестве метрик

Кроме того, сервер MCP содержит встроенную актуальную документацию и позволяет осуществлять поиск по ней без доступа в Интернет.

Более подробную информацию о доступных инструментах и подсказках можно найти в разделе «Использование» .

Вы можете комбинировать функциональность инструментов, поиска документов в своих подсказках и придумывать отличные сценарии использования для вашего экземпляра VictoriaLogs. И, пожалуйста, обратите внимание на тот факт, что качество MCP Server и его ответов во многом зависит от возможностей вашего клиента и качества модели, которую вы используете.

Вы также можете объединить сервер MCP с другими серверами MCP, связанными с наблюдением или поиском документов, и получить еще более мощные результаты.

Related MCP server: Vectara MCP server

Требования

Экземпляр VictoriaLogs ( одноузловой или кластерный )
Используйте версию 1.24 или выше (если вы хотите собрать из исходников)

Установка

Идти

go install github.com/VictoriaMetrics-Community/mcp-victorialogs/cmd/mcp-victorialogs@latest

Исходный код

git clone https://github.com/VictoriaMetrics-Community/mcp-victorialogs.git cd mcp-victorialogs go build -o bin/mcp-victorialogs ./cmd/mcp-victorialogs/main.go # after that add bin/mcp-victorialogs file to your PATH

Двоичные файлы

Просто загрузите последнюю версию со страницы «Релизы» и добавьте ее в PATH.

Докер

Вскоре...

Кузнечное дело

Чтобы автоматически установить VictoriaLogs MCP Server для вашего клиента через Smithery , вы можете использовать следующие команды:

# Get the list of supported MCP clients npx -y @smithery/cli list clients #Available clients: # claude # cline # windsurf # roocode # witsy # enconvo # cursor # vscode # vscode-insiders # boltai # amazon-bedrock # Install VictoriaLogs MCP server for your client npx -y @smithery/cli install @VictoriaMetrics-Community/mcp-victorialogs --client <YOUR-CLIENT-NAME> # and follow the instructions

Конфигурация

Сервер MCP для VictoriaLogs настраивается с помощью переменных среды:

Переменная	Описание	Необходимый	По умолчанию	Допустимые значения
`VL_INSTANCE_ENTRYPOINT`	URL-адрес экземпляра VictoriaLogs	Да	-	-
`VL_INSTANCE_BEARER_TOKEN`	Токен аутентификации для API VictoriaLogs	Нет	-	-
`MCP_SERVER_MODE`	Режим работы сервера	Нет	`stdio`	`stdio` , `sse`
`MCP_SSE_ADDR`	Адрес для прослушивания сервером SSE	Нет	`:8081`	-

Примеры конфигурации

# For a public playground export VL_INSTANCE_ENTRYPOINT="https://play-vmlogs.victoriametrics.com" # Server mode export MCP_SERVER_MODE="sse" export MCP_SSE_ADDR="0.0.0.0:8081"

Настройка в клиентах

Курсор

Перейдите в: Settings -> Cursor Settings -> MCP -> Add new global MCP server и вставьте следующую конфигурацию в файл курсора ~/.cursor/mcp.json :

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Более подробную информацию см. в документации Cursor MCP .

Клод Десктоп

Добавьте это в файл claude_desktop_config.json вашего рабочего стола Claude (его можно найти, открыв Settings -> Developer -> Edit config ):

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Более подробную информацию см. в документации Claude Desktop MCP .

Клод Код

Выполните команду:

claude mcp add victorialogs -- /path/to/mcp-victorialogs \ -e VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> \ -e VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN>

Более подробную информацию см. в документации Claude Code MCP .

Код Visual Studio

Добавьте это в файл конфигурации VS Code MCP:

{ "servers": { "victorialogs": { "type": "stdio", "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Более подробную информацию см. в документации VS Code MCP .

Зед

Добавьте следующее в файл конфигурации Zed:

"context_servers": { "victorialogs": { "command": { "path": "/path/to/mcp-victorialogs", "args": [], "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } }, "settings": {} } } }

Более подробную информацию см. в документации Zed MCP .

JetBrains IDE

Откройте Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP) .
Нажмите Add (+)
Выбрать As JSON
Введите в поле ввода следующее:

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Виндсерфинг

Добавьте следующее в файл конфигурации Windsurf MCP.

{ "mcpServers": { "victorialogs": { "command": "/path/to/mcp-victorialogs", "env": { "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>", "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>" } } } }

Более подробную информацию см. в документации Windsurf MCP .

Амазонка Бедрок

Вскоре....

Использование Docker вместо двоичного кода

Вскоре...

Использование

После установки и настройки сервера MCP вы можете начать использовать его с вашим любимым клиентом MCP.

Диалог с ИИ-помощником можно начать с фразы:

Use MCP VictoriaLogs in the following answers

Но это не обязательно, вы можете просто начать задавать вопросы, и помощник автоматически воспользуется инструментами и документацией, чтобы предоставить вам наилучшие ответы.

Набор инструментов

MCP VictoriaLogs предоставляет множество инструментов для взаимодействия с вашим экземпляром VictoriaLogs.

Вот список доступных инструментов:

Инструмент	Описание
`documentation`	Поиск во встроенной документации VictoriaLogs
`facets`	Наиболее частые значения для каждого поля журнала
`field_names`	Список имен полей для запроса
`field_values`	Список значений полей для запроса
`flags`	Просмотр нестандартных флагов экземпляра VictoriaLogs
`hits`	Количество соответствующих записей журнала, сгруппированных по сегментам
`query`	Выполнение запросов LogsQL
`stats_query`	Запрос статистики журнала за указанное время
`stats_query_range`	Запрос статистики журнала за указанный временной диапазон
`stream_field_names`	Список полей потока для запроса
`stream_field_names`	Список значений полей потока для запроса
`stream_ids`	Список идентификаторов потоков для запроса
`streams`	Список потоков для запроса

Подсказки

Сервер включает в себя предопределенные подсказки для выполнения распространенных задач.

На данный момент это всего лишь примеры, библиотека подсказок будет дополнена в будущем:

Быстрый	Описание
`documentation`	Поиск документации VictoriaLogs по конкретным темам

Отказ от ответственности

Службы и агенты ИИ вместе с серверами MCP, как этот, не могут гарантировать точность, полноту и надежность результатов. Вам следует дважды проверить результаты, полученные с помощью ИИ. Качество сервера MCP и его ответов во многом зависит от возможностей вашего клиента и качества модели, которую вы используете.

Внося вклад

Приветствуются вклады в проект MCP VictoriaLogs! Не стесняйтесь отправлять вопросы, запросы на функции или запросы на извлечение.

mcp-victorialogs

Сервер MCP VictoriaLogs

Функции

Требования

Установка

Идти

Исходный код

Двоичные файлы

Докер

Кузнечное дело

Конфигурация

Примеры конфигурации

Настройка в клиентах

Курсор

Клод Десктоп

Клод Код

Код Visual Studio

Зед

JetBrains IDE

Виндсерфинг

Амазонка Бедрок

Использование Docker вместо двоичного кода

Использование

Набор инструментов

Подсказки

Отказ от ответственности

Внося вклад

Resources

New MCP Servers

Latest Blog Posts

MCP directory API