Skip to main content
Glama
Seq MCP Server

Seq MCP Server

by ahmad2x4

Seq MCP-Server

MCP-Server für die API-Endpunkte von Seq zur Interaktion mit Ihrem Protokollierungs- und Überwachungssystem. Dieser Server bietet umfassenden Zugriff auf die API-Funktionen von Seq über das Model Context Protocol.

Funktionen

Tools

Signalverwaltung

  • get_signals - Abrufen von Signalen mit Filteroptionen

    • Filtern nach Eigentümer-ID

    • Filtern nach freigegebenen/privaten Signalen

    • Unterstützung für Teilübereinstimmungen

Ereignisverwaltung

  • get_events - Abrufen von Ereignissen mit umfangreichen Filteroptionen

    • Filtern nach Signal-IDs

    • Benutzerdefinierte Filterausdrücke

    • Konfigurierbare Ereignisanzahl (maximal 50)

    • Flexible Zeitbereichsoptionen

    • Datumsbereichsfilterung

Warnungsverwaltung

  • get_alert_state - Abrufen des aktuellen Status von Warnungen

Ressourcen

Signalliste

  • signals - Auflisten aller freigegebenen Signale mit detaillierten Informationen

    • Signal-ID

    • Titel

    • Beschreibung

    • Freigabestatus

    • Eigentümerinformationen

Related MCP server: Overwatch MCP

Konfiguration

Der Server erfordert die folgenden Umgebungsvariablen:

  • SEQ_BASE_URL (optional): Ihre Seq-Server-URL (Standard ist 'http://localhost:8080')

  • SEQ_API_KEY (erforderlich): Ihr Seq-API-Schlüssel

seq-ops Skill

Dieses Repository enthält einen Claude-Skill für die Seq-Protokollanalyse und Vorfalluntersuchung. Sobald der MCP-Server verbunden ist, führt der Skill Claude durch strukturierte Untersuchungen – Gesundheitsprüfungen, Vorfall-Triage, Überwachung nach der Bereitstellung – und erstellt konsistente, umsetzbare Berichte.

Installieren Sie den Skill:

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

Oder installieren Sie ihn direkt aus diesem Repository:

npx skills add ahmad2x4/mcp-server-seq

Der Skill wird automatisch aktiviert, wenn Sie Dinge fragen wie "morgendliche Gesundheitsprüfung", "etwas ist in der Produktion kaputt", "überprüfe die Protokolle auf Timeouts" oder "untersuche die PPSR-Integration".


Verwendung mit Claude Code

Führen Sie den folgenden Befehl aus, um den Server hinzuzufügen:

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

Um die Konfiguration mit Ihrem Team zu teilen, verwenden Sie das Flag --scope project (wird in .mcp.json gespeichert):

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-Benutzer: Ersetzen Sie npx -y mcp-seq durch cmd /c npx -y mcp-seq, um "Connection closed"-Fehler zu vermeiden.

Überprüfen Sie, ob der Server verbunden ist, indem Sie /mcp innerhalb von Claude Code ausführen.

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

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

Entwicklung

Abhängigkeiten installieren:

npm install

Server erstellen:

npm run build

Für die Entwicklung mit automatischer Neuerstellung:

npm run dev

Tests ausführen:

npm run test-script

Zeitbereichsoptionen

Das Tool get-events unterstützt die folgenden Zeitbereichsoptionen:

  • 1m - Letzte Minute

  • 15m - Letzte 15 Minuten

  • 30m - Letzte 30 Minuten

  • 1h - Letzte Stunde

  • 2h - Letzte 2 Stunden

  • 6h - Letzte 6 Stunden

  • 12h - Letzte 12 Stunden

  • 1d - Letzter Tag

  • 7d - Letzte 7 Tage

  • 14d - Letzte 14 Tage

  • 30d - Letzte 30 Tage

Installation

Global über npm installieren:

npm install -g mcp-seq

Oder verwenden Sie es direkt mit npx – keine Installation erforderlich (wie in den Konfigurationsbeispielen oben gezeigt).

Debugging

Da MCP-Server über stdio kommunizieren, kann das Debugging eine Herausforderung sein. Der Server implementiert eine ordnungsgemäße Fehlerbehandlung und Protokollierung für alle Vorgänge. Sie können das Testskript ausführen, um die Funktionalität zu überprüfen:

npm run test-script

Typsicherheit

Der Server implementiert umfassende Typsicherheit unter Verwendung von:

  • TypeScript für statische Typüberprüfung

  • Zod-Schema-Validierung für Laufzeit-Typüberprüfung

  • Ordnungsgemäße Fehlerbehandlung und Antwortformatierung

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