Локальный MCP-сервер Loki

Небольшой MCP-сервер только для чтения для локального экземпляра Grafana Loki. Он построен на FastAPI и официальном MCP Python SDK.

Что он предоставляет

• search_logs(service, start, end, text=None) — выполняет поиск по обязательному сервису и необязательному литеральному тексту в обязательном временном диапазоне RFC 3339.

• list_services(start, end) — перечисляет доступные значения метки service-label.

• loki_health() — проверяет, готов ли Loki.

Публичный инструмент не имеет параметра limit. Запрос также опускает параметр запроса limit Loki, поэтому применяется собственное настроенное значение по умолчанию/максимум Loki.

Related MCP server: OpenSearch Logs MCP Server

Запуск

1. Установите Python 3.11 или новее, затем создайте и активируйте виртуальное окружение.

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

2. Задайте переменные окружения в вашей оболочке, если значения по умолчанию не соответствуют вашей настройке. В .env.example перечислены доступные настройки. По умолчанию ожидается Loki по адресу http://127.0.0.1:3100 и метка service_name.

3. Запустите сервер.

uvicorn main:app --reload

Конечная точка MCP Streamable HTTP: http://127.0.0.1:8000/mcp. Собственная конечная точка проверки работоспособности сервера: http://127.0.0.1:8000/health.

Пример

Вызов search_logs с:

{
  "service": "checkout",
  "text": "connection refused",
  "start": "2026-08-26T08:00:00Z",
  "end": "2026-08-26T09:00:00Z"
}

генерирует следующий LogQL-запрос:

{service_name="checkout"} |= "connection refused"

Если ваши метки используют app вместо этого, запустите сервер с $env:LOKI_SERVICE_LABEL = "app".