Wireshark MCP Server

Wireshark MCP サーバー

Model Context Protocol（MCP）を介して、AI エージェント向けにパケットのキャプチャと分析を行います。

あらゆる stdio MCP ホストで動作します：Cursor、Claude Desktop、Claude Code、VS Code / Copilot、Windsurf、カスタムエージェントなどのツールに対応しています。ベンダーロックインはありません。ホストが起動する必要があるのは、次のコマンドだけです：

python -m wireshark_mcp

バージョン 0.2.2

ドキュメント（wiki）
初心者向けセットアップ	TShark と本パッケージをインストール
MCP クライアント	Cursor、Claude、VS Code、汎用
トラブルシューティング	オフラインサーバー、PATH の問題
セキュリティ	安全なキャプチャのルール

GitHub Pages（任意）：Settings → Pages → Source = GitHub Actionsを設定すると、Pages ワークフローが docs/ を HTML として公開します。

利用できる機能

• MCP ツールによるライブキャプチャと pcap/pcapng の分析
• MCP プロンプトによるガイド付きワークフロー
• 起動時の事前チェック：TShark が見つからない場合、プロセスを終了します。これにより、ホストには壊れたツール一覧ではなく、サーバーがオフラインまたはエラーとして表示されます
• 新規ユーザーが推測に頼らずパスを設定できる setup / doctor CLI

必要条件

• Python 3.10+
• TShark（PATH または TSHARK_PATH）
• ライブキャプチャには、Windows では Npcap、Unix では libpcap
• 対象ネットワークでキャプチャを行う権限

クイックスタート（5 分）

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

# Windows:  .venv\Scripts\activate
# Unix:     source .venv/bin/activate

python -m pip install -e .
python -m wireshark_mcp doctor
python -m wireshark_mcp setup

setup は TShark を検出するか、そのパスを尋ね、標準の mcpServers JSON ブロックを書き込むか、出力します。その設定をホストに指定し、ホストを再読み込み／再起動してください。

Windows への Wireshark のインストール：

winget install --id WiresharkFoundation.Wireshark -e

MCP 設定（任意のホスト）

{
  "mcpServers": {
    "wireshark": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["-m", "wireshark_mcp"],
      "env": {
        "TSHARK_PATH": "/absolute/path/to/tshark"
      }
    }
  }
}

Windows のパスの例：

• Python：C:\\Users\\YOU\\...\\wireshark-mcp\\.venv\\Scripts\\python.exe
• TShark：C:\\Program Files\\Wireshark\\tshark.exe

すぐに使えるテンプレート：examples/mcpServers.wireshark.json
クライアントごとのファイルの場所：docs/Clients.md

CLI

コマンド	目的
python -m wireshark_mcp	MCP サーバーを実行（stdio）
python -m wireshark_mcp doctor	依存関係の JSON レポート（終了コード 0/1）
python -m wireshark_mcp setup	TShark とホスト設定を対話形式で行う
python -m wireshark_mcp setup --client print	JSON のみを出力

プロジェクトの構成

src/wireshark_mcp/     # MCP server package (tools, prompts, preflight)
examples/              # Sample mcpServers JSON
docs/                  # Setup wiki for novices
tests/                 # pytest (no live capture by default)
.cursor/skills/        # Optional Cursor agent skill
pyshark_mcp.py         # Thin legacy shim

ツール（抜粋）

分野	ツール
セットアップ	check_environment、configure_tshark
キャプチャ	list_interfaces、quick_capture、capture_live_packets、save_capture_to_file
分析	read_pcap_file、analyze_traffic、deep_packet_analysis、quick_traffic_analysis
アプリケーションプロトコル	analyze_dns_traffic、analyze_http_traffic、analyze_http_traffic_tabular
診断	protocol_hierarchy_statistics、expert_information、filtered_packet_display

プロンプトとリソース

プロンプト： packet_capture_help、investigate_live_traffic、analyze_pcap_file、security_traffic_review、safe_capture_rules

リソース： pyshark://version、pyshark://config（allow_simulation は常に false です）

セキュリティ

• インターフェースは tshark -D の結果を許可リストに登録し、シェルのメタ文字は拒否します
• サブプロセスは argv と shell=False を使用します
• 失敗時はエラーを返します。パケットのシミュレーションは行いません

詳細：docs/Security.md

テストと CI

python -m pip install -e ".[dev]"
pytest -q -m "not live"

GitHub Actions は Ubuntu に TShark をインストールし、ライブキャプチャを除くテストスイートを実行します。

ライセンス

MIT