Repolode
bx33661

bx33661/Wireshark-MCP

AIアシスタントが実パケットデータを使って.pcapを解析できるよう、tsharkへの構造化アクセスを提供するMCPサーバー。

代替できる製品:Wireshark

スター
371
フォーク
47
未解決の Issue
5
最終コミット
5 日前

これは何?

Wireshark MCPは、tsharkと任意のWiresharkスイートツールを、構造化された分析インターフェースとして提供するMCPサーバーです。ユーザーはMCP対応のAIクライアントにキャプチャファイルを指定し、自然言語で質問できます。アシスタントはtsharkを実行するツールを呼び出し、その出力に基づいて回答します。Claude Desktop、Claude Code、Cursor、VS Codeなどのクライアントに対応しています。

デフォルトプロファイルでは54個のツールを提供し、パケット一覧と詳細、HTTPおよびDNSの抽出、集計統計に加え、ポートスキャン、DNSトンネリング、ビーコニング、データ流出、ARPスプーフィングの検出をカバーしています。プロトコル分析ツールは、各プロトコルに適したフィールドと表示フィルターを適用し、25種類のプロトコルをサポートします。検出結果は、証拠箇所を示すアンカーと再確認用のtsharkコマンドを含む共通形式で出力されます。任意で利用できるDuckDBキャプチャインデックスにより大容量ファイルへの反復クエリを高速化でき、ケースファイルを使えば調査結果と判定をセッションをまたいで保持できます。

ツールの出力サイズには上限があり、各ツールは読み取り専用か書き込み可能かを宣言するため、クライアントは読み取り専用の分析を自動承認できます。書き込み可能なツールとリモートHTTPバインドは、設定されたディレクトリとデフォルトのループバック設定によって制限されます。パッケージはPyPIからインストールでき、対話型のクライアント設定コマンドも利用できます。また、Claude CodeおよびCodex向けのプラグイン経由の利用方法もあります。

主な機能

  • 01tsharkの出力を利用する54個のMCPツールで、パケット、ストリーム、統計、セキュリティを分析できます。
  • 021つのプロトコル分析ツールで、適切なフィールドと表示フィルターを選択して25種類のプロトコルを分析できます。
  • 03DNSトンネリング、ポートスキャン、ビーコニング、データ流出、ARPスプーフィングの検出機能を備えています。
  • 04任意でDuckDBキャプチャインデックスを利用でき、大容量キャプチャへのクエリを高速化できます。
  • 05調査結果と判定をJSON形式のケースファイルに保存し、セッションをまたいで保持できます。
  • 06リクエストごとのプロンプトサイズを抑えるため、ツール一覧を絞り込むプロファイルを利用できます。

ユースケース

  • AIアシスタントに.pcapファイルを調べさせ、不審なDNS、HTTP、認証情報の通信をトリアージする。
  • あるホストが最初に出現した時期や、2つのキャプチャ間で通信がどう変化したかを調査する。
  • Modbus、S7comm、Zigbee、BLEなどの産業用または無線プロトコルを、正しいフィールド名で分析する。
  • 調査結果を記録し、セッションをまたいで再開する必要がある長期のインシデント調査を行う。

クイックスタート

  1. 1

    Wireshark(tsharkを含む)をインストールし、tsharkがPATH上にあることを確認します

  2. 2

    PyPIからPythonパッケージをインストールします

    pip install wireshark-mcp
  3. 3

    MCPクライアントにサーバーを登録します(検出されたクライアントから選択)

    wireshark-mcp install

使う前に知っておきたいこと

  • Wiresharkとtsharkを別途インストールする必要があります。このパッケージには含まれていません。
  • WIRESHARK_MCP_ALLOWED_DIRSに既存のディレクトリを指定するまで、ファイルの読み取り・書き込みツールは安全側に動作し、処理を拒否します。

収録されている特集

トピック

#mcp#packet-analysis#tshark#network-security#pcap#wireshark#ai-agents

よくある質問

Wireshark-MCP とは?
AIアシスタントが実パケットデータを使って.pcapを解析できるよう、tsharkへの構造化アクセスを提供するMCPサーバー。 Wireshark MCPは、tsharkと任意のWiresharkスイートツールを、構造化された分析インターフェースとして提供するMCPサーバーです。ユーザーはMCP対応のAIクライアントにキャプチャファイルを指定し、自然言語で質問できます。アシスタントはtsharkを実行するツールを呼び出し、その出力に基づいて回答します。Claude Desktop、Claude Code、Cursor、VS Codeなどのクライアントに対応しています。
Wireshark-MCP は無料で使えますか?ライセンスは?
Wireshark-MCP は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
Wireshark-MCP は今もメンテナンスされていますか?
活発にメンテナンス中。Wireshark-MCP の最終コミットは 2026年11月1日 です。
Wireshark-MCP は何に使えますか?
AIアシスタントに.pcapファイルを調べさせ、不審なDNS、HTTP、認証情報の通信をトリアージする。 あるホストが最初に出現した時期や、2つのキャプチャ間で通信がどう変化したかを調査する。 Modbus、S7comm、Zigbee、BLEなどの産業用または無線プロトコルを、正しいフィールド名で分析する。 調査結果を記録し、セッションをまたいで再開する必要がある長期のインシデント調査を行う。
Wireshark-MCP のインストール方法は?
Wireshark(tsharkを含む)をインストールし、tsharkがPATH上にあることを確認します PyPIからPythonパッケージをインストールします: pip install wireshark-mcp MCPクライアントにサーバーを登録します(検出されたクライアントから選択): wireshark-mcp install
Wireshark-MCP はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/bx33661/Wireshark-MCP

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト

eBPFでKubernetesクラスタの通信をキャプチャ・インデックス化し、TLSを復号して、MCP経由でAIエージェントにデータを提供するネットワーク可観測性ツール。

DevOps・クラウド#kubernetes#ebpf#network-observability
1.2万+18 今週558GoApache-2.0更新 5 日前