Skip to main content
Glama
Seq MCP Server

Seq MCP Server

by ahmad2x4

Seq MCPサーバー

ログ記録および監視システムと対話するためのSeq APIエンドポイント用MCPサーバーです。このサーバーは、Model Context Protocolを通じてSeqのAPI機能への包括的なアクセスを提供します。

機能

ツール

シグナル管理

  • get_signals - フィルタリングオプションを使用してシグナルを取得

    • 所有者IDによるフィルタリング

    • 共有/プライベートシグナルのフィルタリング

    • 部分一致のサポート

イベント管理

  • get_events - 広範なフィルタリングオプションを使用してイベントを取得

    • シグナルIDによるフィルタリング

    • カスタムフィルター式

    • 設定可能なイベント数(最大50)

    • 柔軟な時間範囲オプション

    • 日付範囲フィルタリング

アラート管理

  • get_alert_state - アラートの現在の状態を取得

リソース

シグナル一覧

  • signals - 詳細情報を含むすべての共有シグナルを一覧表示

    • シグナルID

    • タイトル

    • 説明

    • 共有ステータス

    • 所有者情報

Related MCP server: Overwatch MCP

設定

このサーバーには以下の環境変数が必要です:

  • SEQ_BASE_URL (オプション): SeqサーバーのURL (デフォルトは 'http://localhost:8080')

  • SEQ_API_KEY (必須): Seq APIキー

seq-opsスキル

このリポジトリには、Seqのログ分析およびインシデント調査のためのClaudeスキルが含まれています。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ユーザー: 「Connection closed」エラーを回避するために、npx -y mcp-seqをcmd /c npx -y mcp-seqに置き換えてください。

Claude Code内で/mcpを実行して、サーバーが接続されていることを確認します。

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 - 直近1分

  • 15m - 直近15分

  • 30m - 直近30分

  • 1h - 直近1時間

  • 2h - 直近2時間

  • 6h - 直近6時間

  • 12h - 直近12時間

  • 1d - 直近1日

  • 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