Seq MCP Server

Servidor Seq MCP

Servidor MCP para los endpoints de la API de Seq, diseñado para interactuar con tu sistema de registro y monitoreo. Este servidor proporciona acceso integral a las funciones de la API de Seq a través del Protocolo de Contexto de Modelos (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ñales
  • Expresiones de filtro personalizadas
  • Cantidad de eventos configurable (máx. 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 uso compartido
  • Información del propietario

Configuración

El servidor requiere las siguientes variables de entorno:

• SEQ_BASE_URL (opcional): La URL de tu servidor Seq (por defecto: 'http://localhost:8080')
• SEQ_API_KEY (obligatoria): Tu 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 que el servidor MCP esté conectado, la habilidad guía a Claude a través de investigaciones estructuradas — verificaciones de estado, triaje de incidentes, monitoreo posterior al despliegue — y produce informes consistentes y accionables.

Instala la habilidad:

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

O instálala directamente desde este repositorio:

npx skills add ahmad2x4/mcp-server-seq

La habilidad se activa automáticamente cuando haces preguntas como "verificación de salud matutina", "algo está roto en producción", "revisa los registros en busca de tiempos de espera" o "investiga la integración PPSR".

---

Uso con Claude Code

Ejecuta el siguiente comando para agregar 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 tu equipo, usa la bandera --scope project (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: Reemplaza npx -y mcp-seq con cmd /c npx -y mcp-seq para evitar errores de "Connection closed".

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

Uso con Claude Desktop

Agrega a tu 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

Instala las dependencias:

npm install

Compila el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run dev

Ejecuta las 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

Instala globalmente mediante npm:

npm install -g mcp-seq

O úsalo directamente con npx — sin necesidad de 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. Puedes ejecutar el script de prueba para verificar la funcionalidad:

npm run test-script

Seguridad de Tipos

El servidor implementa una seguridad de tipos integral mediante:

• TypeScript para la verificación estática de tipos
• Validación de esquemas Zod para la verificación de tipos en tiempo de ejecución
• Manejo adecuado de errores y formato de respuestas