Skip to main content
Glama
deenesjakoruzh

mcp-victorialogs

by VictoriaMetrics-Community
GitHub
Go
Apache 2.0
29
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Сервер MCP VictoriaLogs

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

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

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

Функции

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

  • Запрос журналов и изучение данных журналов

  • Отображение параметров вашего экземпляра VictoriaLogs

  • Список доступных потоков, полей, значений полей

  • Запрос статистики для журналов в качестве метрик

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

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

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

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

Требования

Установка

Идти

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! Не стесняйтесь отправлять вопросы, запросы на функции или запросы на извлечение.

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

mcp-victorialogs

  1. Функции
    1. Требования
      1. Установка
        1. Идти
        2. Исходный код
        3. Двоичные файлы
        4. Докер
        5. Кузнечное дело
      2. Конфигурация
        1. Примеры конфигурации
      3. Настройка в клиентах
        1. Курсор
        2. Клод Десктоп
        3. Клод Код
        4. Код Visual Studio
        5. Зед
        6. JetBrains IDE
        7. Виндсерфинг
        8. Амазонка Бедрок
        9. Использование Docker вместо двоичного кода
      4. Использование
        1. Набор инструментов
        2. Подсказки
      5. Отказ от ответственности
        1. Внося вклад

          Related MCP Servers

          View all related MCP servers

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/VictoriaMetrics-Community/mcp-victorialogs'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server