Loki MCP Server

Простой сервер Loki MCP

Loki MCP Server — это интерфейс Model Context Protocol (MCP) для запроса журналов Grafana Loki с помощью logcli . Сервер позволяет помощникам ИИ получать доступ к данным журналов Loki и анализировать их напрямую.

Функции

• Запрос журналов Loki с полной поддержкой LogQL
• Получить значения меток и метаданные
• Поддержка аутентификации и настройки через переменные среды или файлы конфигурации
• Предоставляет отформатированные результаты в различных форматах вывода (по умолчанию, необработанные, строки JSON)
• Автоматический возврат к HTTP API, если logcli недоступен в среде

Предпосылки

• Node.js v16 или выше
• Машинопись
• (Необязательно) Grafana Loki logcli установлен и доступен в вашем PATH. Если logcli недоступен, сервер автоматически будет использовать Loki HTTP API вместо этого
• Доступ к экземпляру сервера Loki

Установка

Установка через Smithery

Чтобы автоматически установить Simple Loki MCP Server для Claude Desktop через Smithery :

для МКП

нпм

1. Клонируйте репозиторий:

2. Установить зависимости:

3. Создайте проект:

Доступные инструменты MCP

запрос-локи

Запрос журналов из Loki с возможностью фильтрации.

Параметры:

• query (обязательно): строка запроса Loki (LogQL)
• from : начальная временная метка (например, "2023-01-01T12:00:00Z")
• to : конечная временная метка (например, «2023-01-01T13:00:00Z»)
• limit : Максимальное количество возвращаемых журналов
• batch : Размер пакета для результатов запроса
• output : Формат вывода («по умолчанию», «сырой» или «jsonl»)
• quiet : Подавить метаданные запроса
• forward : Отображать результаты в хронологическом порядке

получить-метки-значения

Получить все значения для определенной метки.

Параметры:

• label (обязательно): Имя метки для получения значений

получить-метки

Получить все доступные метки.

Параметры не требуются.

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

Вы можете настроить доступ к Loki, используя:

Переменные среды

• LOKI_ADDR : адрес сервера Loki (URL)
• LOKI_USERNAME : Имя пользователя для базовой аутентификации
• LOKI_PASSWORD : Пароль для базовой аутентификации
• LOKI_TENANT_ID : идентификатор арендатора для многоарендного Loki
• LOKI_BEARER_TOKEN : Токен на предъявителя для аутентификации
• LOKI_BEARER_TOKEN_FILE : Файл, содержащий токен на предъявителя
• LOKI_CA_FILE : Пользовательский файл CA для TLS
• LOKI_CERT_FILE : Файл клиентского сертификата для TLS
• LOKI_KEY_FILE : Файл ключа клиента для TLS
• LOKI_ORG_ID : идентификатор организации для многоорганизационных настроек
• LOKI_TLS_SKIP_VERIFY : Пропустить проверку TLS («истина» или «ложь»)
• LOKI_CONFIG_PATH : Пользовательский путь к файлу конфигурации
• DEBUG : включить ведение журнала отладки

Примечание : когда клиент использует режим HTTP API (когда logcli недоступен), для аутентификации и подключения к серверу Loki используются те же параметры конфигурации.

Файлы конфигурации

Либо создайте файл logcli-config.yaml в одном из следующих мест:

• Пользовательский путь, указанный LOKI_CONFIG_PATH
• Текущий рабочий каталог
• Ваш домашний каталог ( ~/.logcli-config.yaml )

Пример файла конфигурации:

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

Запустите сервер:

Для разработки:

Подробности реализации

Автоматический возврат к HTTP API

Сервер автоматически проверит, установлен ли logcli и доступен ли он в среде:

1. Если logcli доступен, он будет использоваться для всех запросов, обеспечивая полную функциональность инструмента CLI.
2. Если logcli недоступен, сервер автоматически вернется к использованию Loki HTTP API:
   • Никакой дополнительной настройки не требуется.
   • Для HTTP API используются те же параметры аутентификации.
   • Форматирование ответа соответствует выходным данным CLI.
   • В обоих режимах применяется ограничение по умолчанию в 1000 журналов на запрос.

Автоматическое обнаружение гарантирует бесперебойную работу сервера в различных средах без необходимости ручной настройки.

Разработка

Лицензия

Данный проект лицензирован по лицензии MIT — подробности смотрите в файле LICENSE.md .