Sharkmcp

🚀 SharkMCP - ネットワークパケット分析MCPサーバー

Wireshark/tsharkを統合することで、ネットワークパケットのキャプチャと分析機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。AIアシスタントがネットワークセキュリティ分析、トラブルシューティング、パケット検査を行うために設計されています。

このサーバーは、エージェントがリクエストを送信するプログラムをデバッグし、パケットトラフィックを検証したいシチュエーションを想定しています。以下のワークフローを可能にします。

• パケットの記録を開始
• ツールを実行またはリクエストを行う
• 記録を停止し、結果を分析

🚀 クイックスタート

SharkMCPサーバーを使用することで、ネットワークパケットのキャプチャと分析が可能になります。以下の手順でサーバーを起動しましょう。

✨ 主な機能

• 非同期パケットキャプチャ：設定可能なフィルターとタイムアウトでバックグラウンドのキャプチャセッションを開始します。
• PCAPファイル分析：既存のパケットキャプチャファイルを分析します。
• 柔軟な出力形式：JSON、カスタムフィールド、または従来のテキスト出力をサポートします。
• SSL/TLS復号化：SSLキーログファイルを使用してHTTPSトラフィックを復号化します。
• 再利用可能な設定：キャプチャ/分析の設定を保存して再利用できます。

⚠️ 重要提示

パケット情報は非常に多くなる可能性があります。会話のコンテキストが過負荷にならないように、スコープ付きの表示フィルターを使用することを確認してください。

📦 インストール

前提条件

システム要件

• Wireshark/tshark：インストールされ、アクセス可能である必要があります。
• Node.js：バージョン18以上
• pnpm：パッケージマネージャー（推奨）

Wireshark/tsharkのインストール

macOS（Homebrewを使用）:

brew install wireshark

Ubuntu/Debian:

sudo apt update
sudo apt install tshark wireshark-common

Windows: wireshark.orgからダウンロードしてください。

サーバーのインストール

1. リポジトリをクローンする:

git clone https://github.com/kriztalz/SharkMCP.git
cd SharkMCP

2. 依存関係をインストールする:

pnpm install

3. プロジェクトをビルドする:

pnpm run build

4. サーバーを起動する:

pnpm start

💻 使用例

基本的な使用法

キャプチャセッションを開始する

Interface: en0
Capture Filter: port 443
Timeout: 30 seconds

キャプチャされたトラフィックを分析する

Display Filter: tls.handshake.type == 1
Output Format: json

設定を保存する

{
  "name": "https-monitoring",
  "description": "Monitor HTTPS traffic",
  "captureFilter": "port 443",
  "displayFilter": "tls.handshake.type == 1",
  "outputFormat": "json",
  "timeout": 60,
  "interface": "en0"
}

高度な使用法

SharkMCPには、さまざまな高度な機能が備わっています。例えば、SSL/TLS復号化や再利用可能な設定などを活用することができます。

📚 ドキュメント

利用可能なツール

1. start_capture_session：バックグラウンドでのパケットキャプチャを開始します。
2. stop_capture_session：キャプチャを停止し、結果を分析します。
3. analyze_pcap_file：既存のPCAPファイルを分析します。
4. manage_config：再利用可能な設定を保存/読み込みます。

設定

MCPクライアントの設定

{
  "mcpServers": {
    "sharkmcp": {
      "command": "node",
      "args": ["/path/to/SharkMCP/dist/index.js"],
    }
  }
}

SSL/TLS復号化（オプション）

HTTPSトラフィックを復号化するには、SSLKEYLOGFILE環境変数をエクスポートします。

export SSLKEYLOGFILE=/path/to/sslkeylog.log

次に、アプリケーションを設定して、このファイルにSSLキーをログに記録します。多くのアプリケーションは、環境変数が設定されていると自動的にこれをサポートします。

その後、stop_capture_sessionツールでログファイルのパス名をMCPサーバーに渡します。

🔧 技術詳細

アーキテクチャ

SharkMCPは、シンプルなローカル開発を中心としたアーキテクチャを提供します。

┌─────────────────────────────────────────────────────────┐
│                    SharkMCP Server                      │
├─────────────────────────────────────────────────────────┤
│  MCP Protocol Layer                                     │
│  ├─ start_capture_session                               │
│  ├─ stop_capture_session                                │
│  ├─ analyze_pcap_file                                   │
│  └─ manage_config                                       │
├─────────────────────────────────────────────────────────┤
│  tshark Integration Layer                               │
│  ├─ Cross-platform executable detection                 │
│  ├─ Process management                                  │
│  └─ Output parsing (JSON/fields/text)                   │
├─────────────────────────────────────────────────────────┤
│  Host System Integration                                │
│  ├─ Local tshark installation                           │
│  ├─ Direct network interface access                     │
│  └─ Native file system operations                       │
└─────────────────────────────────────────────────────────┘

プロジェクト構造

SharkMCP/
├── src/
│   ├── index.ts              # メインサーバーの設定
│   ├── types.ts              # TypeScriptのインターフェース
│   ├── utils.ts              # ユーティリティ関数
│   └── tools/                # 個々のツールの実装
│       ├── start-capture-session.ts
│       ├── stop-capture-session.ts
│       ├── analyze-pcap-file.ts
│       └── manage-config.ts
├── test/                     # テストファイル
│   └── integration.test.js   # 統合テスト
├── package.json
└── README.md

開発コマンド

# 自動リロードで開発モードを起動
pnpm run dev

# 本番用にビルド
pnpm run build

# テストを実行
pnpm run test

# 型チェック
pnpm run build

トラブルシューティング

一般的な問題

"tshark not found"：

• Wiresharkがインストールされていることを確認し、tsharkがPATHに含まれていることを確認してください。
• インストールを確認するには、tshark -vを実行します。

パケットキャプチャの権限が拒否された場合：

• Linuxの場合：ユーザーをwiresharkグループに追加するか、sudoで実行してください。
• macOSの場合：システム環境設定でターミナルにネットワークアクセスを許可してください。
• Windowsの場合：管理者として実行してください。

パケットがキャプチャされない場合：

• ネットワークインターフェース名を確認してください（Linuxではip link、macOSではifconfig）。
• キャプチャフィルターの構文を確認してください。
• インターフェースにトラフィックが存在することを確認してください。

貢献（大歓迎！）

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 既存のコードスタイルに従って変更を加えます。
4. 新しい機能に対するテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス

問題 / 提案

何か質問や提案があれば、自由にIssueを開いてください。