Skip to main content
Glama
Seq MCP Server

Seq MCP Server

by ahmad2x4

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: Overwatch MCP

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

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

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

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

Навык seq-ops

Этот репозиторий включает навык Claude для анализа логов Seq и расследования инцидентов. После подключения MCP-сервера навык направляет Claude через структурированные расследования — проверки работоспособности, сортировку инцидентов, мониторинг после развертывания — и создает последовательные, пригодные для использования отчеты.

Установка навыка:

# From the releases page, download seq-ops.skill, then:
claude skill install seq-ops.skill

Или установите напрямую из этого репозитория:

npx skills add ahmad2x4/mcp-server-seq

Навык автоматически активируется, когда вы задаете вопросы вроде "утренняя проверка работоспособности", "что-то сломалось в продакшене", "проверь логи на наличие таймаутов" или "расследуй интеграцию PPSR".


Использование с 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 для проверки типов во время выполнения

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

Available Tools

3 tools
get-alertstateD

Inputs: no named parameters.

get-eventsB

Retrieve and analyze a list of event filtered by parameters. Use this tool when you need to:

  • Investigate events that are being logged in the SEQ server

  • Details of each event is a structured log and can provide usefull information

  • Events could be information, error, debug, or critical

  • Analyze error patterns and frequencies

Inputs: signal, filter, count, fromDateUtc, +2 more.

get-signalsD

Inputs: ownerId, shared, partial.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.9/5.0

    Scored across 3 tools

    Disambiguation3/5

    The tools appear to target different aspects of a Seq server (alert state, events, signals), but with only one description available for 'get-events', it's unclear how 'get-alertstate' and 'get-signals' differ in purpose. This creates some ambiguity, though the distinct names suggest separate functions.

    Naming Consistency5/5

    All three tools follow a consistent 'get-[noun]' naming pattern using kebab-case, which is predictable and readable. There are no deviations in style or verb usage across the tool set.

    Tool Count2/5

    With only 3 tools, this server feels under-scoped for a logging/monitoring domain like Seq, which typically involves more operations such as creating alerts, filtering logs, or managing signals. The count is too low to cover the apparent scope effectively.

    Completeness2/5

    The tool set is severely incomplete for a Seq server, lacking essential operations like creating or updating alerts, sending logs, or configuring signals. Only read-only 'get' operations are provided, which will limit agents to passive monitoring without the ability to interact or modify the system.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for retrieving and filtering logs from Mezmo with a quota-conscious design and intelligent defaults. It enables users to discover and query logs by application, level, and custom time ranges to streamline debugging while minimizing API usage.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables querying logs and metrics from Graylog, Prometheus, and InfluxDB 2.x. It provides tools for executing Lucene log searches, PromQL queries, and Flux queries directly within MCP-compatible clients.
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      MCP server that integrates with Sumo Logic's API to perform log searches, data discovery, metrics queries, and monitoring.
      15
      22 npm
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for querying structured logs from Datalust Seq, providing tools to search logs, retrieve recent errors, fetch events, and check health.
      MIT