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 Besitzer-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 (max. 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

  • Besitzerinformationen

Related MCP server: MCP Server

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

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 (speichert in .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-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 automatischem Neuaufbau:

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 direkt mit npx verwenden – keine Installation erforderlich (wie in den Konfigurationsbeispielen oben gezeigt).

Debugging

Da MCP-Server über stdio kommunizieren, kann das Debugging schwierig 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