MCP Wireshark

mcp-wireshark

Wireshark／tshark 用のコミュニティ運営 MCP サーバーです。Wireshark または Anthropic とは提携していません。 AI アシスタントからパケットキャプチャに直接アクセスできます。Claude に .pcap の要約、TCP ストリームの追跡、特定のプロトコルのフィルタリング、ライブトラフィックのキャプチャなどをチャットから離れずに依頼できます。

Claude Code ですぐに使う

pip install mcp-wireshark
claude mcp add --transport stdio --scope user mcp-wireshark -- mcp-wireshark

これで完了です。Claude Code を開いて、次のように試してください。

「./capture.pcap を要約して、最も多く通信した IP を教えてください。」

--scope user を指定すると、すべての Claude Code プロジェクトでサーバーを利用できます。このフラグを省略すると、現在のプロジェクトにのみインストールされます。詳しくは claude mcp docs をご覧ください。

インストールを確認する

claude mcp list

mcp-wireshark が表示されます。Claude Code 内で、次のように尋ねてください。

「check_installation を実行してください。」

PATH に tshark があれば、バージョンが返されます。ない場合は、トラブルシューティングをご覧ください。

ツール

このサーバーは、読み取りツール（安全で、副作用なし）と書き込みツール（トラフィックをキャプチャするか、ファイルを書き込む）の2つに明確に分けられた、14個のツールを提供します。どちらのグループにも標準の MCP readOnlyHint が注釈されているため、準拠するクライアントであれば、その違いを表示できます。

読み取りツール

自由に呼び出しても安全です。状態を調べるだけです。

書き込みツール

これらのツールはファイルを作成したり、ライブトラフィックをキャプチャしたりします。準拠クライアントでは、実行前に確認を求める場合があります。

動作の様子

以下のクリップでは、demo/demo.pcapng（短時間のホームネットワークのキャプチャ）に対して実際のツールを実行しています。python demo/render_gif.py <scene> で再生成できます。

summarize_pcap — 不明なキャプチャの特徴を一目で把握します

decode_protocol — プロトコルで絞り込み、簡潔な表を取得します（ここではTLS SNIとDNS-over-HTTPSのルックアップを表示）

expert_info — tsharkに警告や異常を検出してもらいます

プロンプトの例

以下をそのままClaude Codeに入力してください。

List my network interfaces.
Summarize ./traffic.pcap.
From ./traffic.pcap, show me only HTTP requests.
Follow TCP stream 0 in ./traffic.pcap and tell me what protocol is in it.
Capture 30 seconds of traffic on Wi-Fi filtered to tcp.port == 443.
Export every DNS packet from ./traffic.pcap to ./dns.json.
Decode the GOOSE messages in ./substation.pcapng — only stNum >= 1.
Run expert analysis on ./traffic.pcap and group findings by severity.
Show me the IP conversations in ./traffic.pcap.

便利な表示フィルター

IEC 61850トラフィックを分析する変電所エンジニア向け：

その他のクライアント

MCPに対応していれば、どのクライアントでも使用できます。このパッケージをインストールすると、PATH 上に mcp-wireshark バイナリが配置されます。

{
    "mcpServers": {
        "wireshark": {
            "command": "mcp-wireshark"
        }
    }
}

{
    "servers": {
        "wireshark": {
            "command": "mcp-wireshark"
        }
    }
}

前提条件

• Python 3.10+
• Wireshark がインストールされ、tshark に PATH からアクセスできること

pip または uv でインストールします。

pip install mcp-wireshark
# or
uvx mcp-wireshark

トラブルシューティング

sudo usermod -aG wireshark $USER

開発

git clone https://github.com/khuynh22/mcp-wireshark.git
cd mcp-wireshark
python -m venv venv && source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -e ".[dev]"

pytest                   # tests
black src tests          # format
ruff check src tests     # lint
mypy src                 # type check

コードベースは、新しいツールを明確に範囲分けされた次のいずれかのファイルに追加できるよう構成されています。

• src/mcp_wireshark/read_tools.py — 状態を調査するだけのもの
• src/mcp_wireshark/write_tools.py — トラフィックをキャプチャする、またはファイルを書き込むもの

server.py にはルーティングのみが含まれています。CLAUDE.md と CONTRIBUTING.md を参照してください。

セキュリティ

すべてのファイルパスが検証されます（.. は拒否され、拡張子は許可リストで制限されます）。すべての表示フィルターでシェルのメタ文字がチェックされます。tshark は常に asyncio.create_subprocess_exec 経由で呼び出され、shell=True は使用されません。上限は、呼び出しあたり 10k パケット、ライブキャプチャあたり 5 min です。SECURITY.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。