Skip to main content
Glama
Seq MCP Server

Seq MCP Server

by ahmad2x4

Servidor MCP de Seq

Servidor MCP para los endpoints de la API de Seq para interactuar con su sistema de registro y supervisión. Este servidor proporciona acceso integral a las funciones de la API de Seq a través del Protocolo de Contexto de Modelo (MCP).

Características

Herramientas

Gestión de señales

  • get_signals - Obtener señales con opciones de filtrado

    • Filtrar por ID de propietario

    • Filtrar señales compartidas/privadas

    • Soporte para coincidencias parciales

Gestión de eventos

  • get_events - Recuperar eventos con amplias opciones de filtrado

    • Filtrar por IDs de señal

    • Expresiones de filtro personalizadas

    • Recuento de eventos configurable (máximo 50)

    • Opciones flexibles de rango de tiempo

    • Filtrado por rango de fechas

Gestión de alertas

  • get_alert_state - Recuperar el estado actual de las alertas

Recursos

Listado de señales

  • signals - Listar todas las señales compartidas con información detallada

    • ID de señal

    • Título

    • Descripción

    • Estado de compartición

    • Información del propietario

Related MCP server: Overwatch MCP

Configuración

El servidor requiere las siguientes variables de entorno:

  • SEQ_BASE_URL (opcional): La URL de su servidor Seq (por defecto 'http://localhost:8080')

  • SEQ_API_KEY (obligatorio): Su clave de API de Seq

Habilidad seq-ops

Este repositorio incluye una habilidad de Claude para el análisis de registros de Seq y la investigación de incidentes. Una vez conectado el servidor MCP, la habilidad guía a Claude a través de investigaciones estructuradas (comprobaciones de estado, triaje de incidentes, supervisión posterior al despliegue) y genera informes coherentes y procesables.

Instalar la habilidad:

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

O instálela directamente desde este repositorio:

npx skills add ahmad2x4/mcp-server-seq

La habilidad se activa automáticamente cuando pregunta cosas como "morning health check", "something is broken in prod", "check the logs for timeouts" o "investigate the PPSR integration".


Uso con Claude Code

Ejecute el siguiente comando para añadir el servidor:

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

Para compartir la configuración con su equipo, utilice la bandera --scope project (se guarda en .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

Usuarios de Windows: Reemplace npx -y mcp-seq con cmd /c npx -y mcp-seq para evitar errores de "Connection closed".

Verifique que el servidor esté conectado ejecutando /mcp dentro de Claude Code.

Uso con Claude Desktop

Añada a su 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"
      }
    }
  }
}

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para el desarrollo con reconstrucción automática:

npm run dev

Ejecutar pruebas:

npm run test-script

Opciones de rango de tiempo

La herramienta get-events admite las siguientes opciones de rango de tiempo:

  • 1m - Último minuto

  • 15m - Últimos 15 minutos

  • 30m - Últimos 30 minutos

  • 1h - Última hora

  • 2h - Últimas 2 horas

  • 6h - Últimas 6 horas

  • 12h - Últimas 12 horas

  • 1d - Último día

  • 7d - Últimos 7 días

  • 14d - Últimos 14 días

  • 30d - Últimos 30 días

Instalación

Instalar globalmente a través de npm:

npm install -g mcp-seq

O utilícelo directamente con npx — no requiere instalación (como se muestra en los ejemplos de configuración anteriores).

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. El servidor implementa un manejo de errores y registro adecuados para todas las operaciones. Puede ejecutar el script de prueba para verificar la funcionalidad:

npm run test-script

Seguridad de tipos

El servidor implementa una seguridad de tipos integral utilizando:

  • TypeScript para la comprobación de tipos estáticos

  • Validación de esquemas Zod para la comprobación de tipos en tiempo de ejecución

  • Manejo de errores y formato de respuesta adecuados

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