mcp-server-logs-sieve

mcp-server-logs-sieve — это MCP-сервер, который позволяет ИИ-ассистентам запрашивать логи напрямую из вашего бэкенда наблюдаемости.

Задавайте вопросы по отладке на обычном языке, и пусть Logs Sieve извлекает для вас точные логи и контекст.

Зачем это нужно

Во время инцидентов много времени уходит на повторяющиеся действия:

• поиск нужного источника логов

• сужение временного интервала

• выявление повторяющихся шаблонов сбоев

• отслеживание одного запроса (trace) между сервисами

Logs Sieve упаковывает эти рабочие процессы в четыре инструмента: query_logs, summarize_logs, trace_request и list_log_sources.

Related MCP server: Azure Logs MCP

Поддерживаемые провайдеры

• Google Cloud Logging (gcp)

• AWS CloudWatch Logs (aws)

• Azure Monitor Logs (azure)

• Grafana Loki (loki)

• Elasticsearch (elasticsearch)

Предварительные требования

⚠️ Требуется Node.js 20 или выше.

Этот пакет использует ES-модули и зависимости, которым нужен Node.js 20+. Если вы видите ошибки ERR_MODULE_NOT_FOUND, проверьте версию Node с помощью node -v и при необходимости обновитесь.

Это применимо независимо от того, запускаете ли вы через npx, устанавливаете глобально или используете исходный код.

Быстрая настройка MCP

Пример .mcp.json:

{
  "mcpServers": {
    "logs-sieve": {
      "command": "npx",
      "args": ["-y", "mcp-server-logs-sieve@latest", "--provider", "gcp"]
    }
  }
}

Если вы запускаете сервер напрямую из исходного кода этого репозитория, вы все равно можете использовать node ./bin/mcp-server-logs-sieve.js --provider gcp.

Первичная настройка: При первом использовании npx должен скачать и установить пакет (~40 секунд). Claude Code может превысить время ожидания. Выполните следующую команду один раз в терминале, чтобы подготовить кэш перед добавлением в конфигурацию MCP:

npx mcp-server-logs-sieve@latest --provider gcp
# (Ctrl+C once it starts — you just need the install to complete)

После этого Claude Code будет мгновенно запускать сервер из кэша npx.

После обновления конфигурации перезапустите MCP-клиент и подтвердите работу командой /mcp.

Аутентификация провайдеров и переменные окружения

См. документацию по настройке и аутентификации для конкретных провайдеров:

• GCP

• AWS

• Azure

• Loki

• Elasticsearch

Для заголовков совместимости API Elasticsearch:

export ELASTICSEARCH_COMPAT_VERSION=8

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

Пакет также включает CLI для прямого использования в терминале:

mcp-server-logs-sieve query --provider gcp --scope my-project --last 1h --filter "payment failed"
mcp-server-logs-sieve summarize --provider gcp --scope my-project --last 24h
mcp-server-logs-sieve trace --provider gcp --scope my-project --trace <trace-id>
mcp-server-logs-sieve sources --provider gcp --scope my-project

Документация

• Главная страница документации

• Начало работы

• Настройка MCP-клиента (Claude Code, Claude Desktop, Cursor, Windsurf)

• Справочник инструментов

• Устранение неполадок

• Матрица совместимости

Вклад в проект

Мы приветствуем любой вклад.

• Начните отсюда: CONTRIBUTING.md

• Проблемы (Issues): https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/issues

• Обсуждения: https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/discussions