Mcp Server Seq

Seq MCP サーバー

ログおよび監視システムと連携するための、Seq の API エンドポイント向け MCP サーバーです。このサーバーは、Model Context Protocol を通じて Seq の API 機能を包括的に利用できるようにします。

機能

ツール

シグナルの管理

• get_signals - フィルタリングオプションを指定してシグナルを取得します
  • オーナー ID でフィルタリング
  • 共有／非公開シグナルをフィルタリング
  • 部分一致に対応

イベントの管理

• get_events - 豊富なフィルタリングオプションを指定してイベントを取得します
  • シグナル ID でフィルタリング
  • カスタムフィルター式
  • イベント数を設定可能（最大 50 件）
  • 柔軟な期間オプション
  • 日付範囲でのフィルタリング

アラートの管理

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

リソース

シグナル一覧

• signals - すべての共有シグナルを詳細情報とともに一覧表示します
  • シグナル ID
  • タイトル
  • 説明
  • 共有状態
  • オーナー情報

設定

サーバーには、次の環境変数が必要です。

• 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 スキーマ検証を使用
• 適切なエラー処理とレスポンスのフォーマット