Wireshark MCP

🚀 Wireshark MCP サーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）を通じて PyShark の機能を公開し、Claude のような AI アシスタントがネットワークパケットのキャプチャと分析機能とやり取りできるようにします。

📦 インストール

1. 必要な依存関係をインストールします：

# uv を使用する（推奨）
uv add mcp[cli] pyshark

# または pip を使用する
pip install mcp[cli] pyshark

2. このリポジトリをクローンします：

git clone https://github.com/A-G-U-P-T-A/wireshark-mcp
cd wireshark-mcp

🔧 技術詳細

要件

• Python 3.8 以上
• TShark（Wireshark のコマンドラインコンポーネント）がインストールされている必要があります
• リアルタイムパケットキャプチャには管理権限/ルート権限が必要です

💻 使用例

基本的な使用法

サーバーの起動

開発モードでサーバーを起動し、MCP チェッカーを使用することができます：

mcp dev pyshark_mcp.py

または、Claude Desktop で直接インストールすることもできます：

mcp install pyshark_mcp.py

高度な使用法

利用可能な機能

この MCP サーバーは以下の内容を公開します：

リソース

• pyshark://version - PyShark のバージョン情報を取得します
• pyshark://config - PyShark の設定を取得します
• pyshark://capture-history - 以前のパケットキャプチャ履歴を取得します

ツール

• list_interfaces - すべての利用可能なネットワークインターフェイスをリストします
• capture_live_packets - ネットワークインターフェイスからリアルタイムでパケットをキャプチャします
• read_pcap_file - パケットキャプチャファイルを読み取り、分析します
• analyze_traffic - キャプチャされたパケット内のネットワークトラフィックパターンを分析します

advanced_captures.py で提供される高度なツール：

• capture_targeted_traffic - 特定のホスト、ポート、またはプロトコルを対象としたトラフィックをキャプチャします
• capture_to_file - ネットワークトラフィックをキャプチャし、pcap ファイルとして保存します
• analyze_http_traffic - キャプチャファイル内の HTTP トラフィックを分析します
• detect_network_protocols - 使用されているネットワークプロトコルを検出し、報告します

ヒント

• packet_capture_help - PyShark を使用したパケットキャプチャに関するヘルプ情報を提供します

Claude での使用例

Claude Desktop にサーバーがインストールされたら、次のようにやり取りすることができます：

あなた：キャプチャに利用可能なネットワークインターフェイスは何ですか？

Claude：あなたのシステムで利用可能なネットワークインターフェイスを確認します。
[list_interfaces ツールを呼び出す]

あなた：10 秒間の HTTP トラフィックをキャプチャできますか？

Claude：10 秒間の HTTP トラフィックをキャプチャします。
[capture_live_packets と適切なパラメータを呼び出す]

あなた：私がキャプチャしたトラフィックを分析できますか？

Claude：以下はキャプチャされたトラフィックの分析結果です：
[analyze_traffic を呼び出して洞察を提供する]

ネットワークトラフィックをキャプチャする権限があることを常に確認してください。

📄 ライセンス

⚠️ 重要提示

ネットワークパケットキャプチャは機密性の高い操作です。以下のことを確認してください：

1. ネットワークトラフィックをキャプチャする合法的な許可を取得していること
2. すべての適用される法律および規制を遵守すること
3. 機密または個人情報を誤ってキャプチャしないこと
4. キャプチャファイルを安全に処理し、不正アクセスを防止すること

要件

• PyShark：TShark の Python ラッパー
• TShark：Wireshark のコマンドラインバージョン（個別にインストールする必要があります）
• 管理権限：通常、リアルタイムパケットキャプチャに必要です