mcp-victorialogs

Сервер MCP VictoriaLogs

Лицензия Слак Реддит

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

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

Функции

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

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

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

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

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

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

Требования

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