Seq MCP Server

MCP-сервер для API-эндпоинтов Seq, предназначенный для взаимодействия с вашей системой логирования и мониторинга. Этот сервер предоставляет полный доступ к функциям API Seq через протокол Model Context Protocol.

Функции

Инструменты

Управление сигналами

• get_signals — получение сигналов с опциями фильтрации

  • Фильтрация по ID владельца

  • Фильтрация общих/приватных сигналов

  • Поддержка частичного совпадения

Управление событиями

• get_events — получение событий с широкими возможностями фильтрации

  • Фильтрация по ID сигналов

  • Пользовательские выражения фильтрации

  • Настраиваемое количество событий (макс. 50)

  • Гибкие опции временного диапазона

  • Фильтрация по диапазону дат

Управление оповещениями

• get_alert_state — получение текущего состояния оповещений

Ресурсы

Список сигналов

• signals — список всех общих сигналов с подробной информацией

  • ID сигнала

  • Заголовок

  • Описание

  • Статус общего доступа

  • Информация о владельце

Related MCP server: MCP Server

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

Сервер требует следующие переменные окружения:

• SEQ_BASE_URL (необязательно): URL вашего сервера Seq (по умолчанию 'http://localhost:8080')

• SEQ_API_KEY (обязательно): Ваш API-ключ Seq

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

Выполните следующую команду, чтобы добавить сервер:

claude mcp add --transport stdio \
  --env SEQ_BASE_URL=http://localhost:5341 \
  --env SEQ_API_KEY=your-api-key \
  seq -- npx -y mcp-seq

Чтобы поделиться конфигурацией с вашей командой, используйте флаг --scope project (сохраняет в .mcp.json):

claude mcp add --transport stdio --scope project \
  --env SEQ_BASE_URL=http://localhost:5341 \
  --env SEQ_API_KEY=your-api-key \
  seq -- npx -y mcp-seq

Пользователи Windows: Замените npx -y mcp-seq на cmd /c npx -y mcp-seq, чтобы избежать ошибок "Connection closed".

Проверьте подключение сервера, выполнив /mcp внутри Claude Code.

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

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "seq": {
      "command": "npx",
      "args": ["-y", "mcp-seq"],
      "env": {
        "SEQ_BASE_URL": "your-seq-url",
        "SEQ_API_KEY": "your-api-key"
      }
    }
  }
}

Разработка

Установите зависимости:

npm install

Соберите сервер:

npm run build

Для разработки с автоматической пересборкой:

npm run dev

Запустите тесты:

npm run test-script

Опции временного диапазона

Инструмент get-events поддерживает следующие опции временного диапазона:

• 1m — Последняя минута

• 15m — Последние 15 минут

• 30m — Последние 30 минут

• 1h — Последний час

• 2h — Последние 2 часа

• 6h — Последние 6 часов

• 12h — Последние 12 часов

• 1d — Последний день

• 7d — Последние 7 дней

• 14d — Последние 14 дней

• 30d — Последние 30 дней

Установка

Установите глобально через npm:

npm install -g mcp-seq

Или используйте напрямую с npx — установка не требуется (как показано в примерах конфигурации выше).

Отладка

Поскольку MCP-серверы обмениваются данными через stdio, отладка может быть сложной. Сервер реализует надлежащую обработку ошибок и логирование для всех операций. Вы можете запустить тестовый скрипт для проверки функциональности:

npm run test-script

Типобезопасность

Сервер реализует комплексную типобезопасность с использованием:

• TypeScript для статической проверки типов

• Zod для проверки типов во время выполнения

• Надлежащей обработки ошибок и форматирования ответов