モデルコンテキストプロトコル(MCP)を介してAIエージェントのパケットキャプチャと分析。

** 任意の stdio MCP ホストで動作します**: カーソル, クロード デスクトップ, クロード コード, VS コード / コパイロット, ウィンドサーフィン, カスタム エージェント, 同様のツール. ベンダーのロックインなし — ホストは起動するだけです:

バージョン 0.2.2

| ドキュメント | お問い合わせ | 初心者向けセットアップ | TShark + このパッケージをインストール | | MCPクライアント | キュラー、クロード、VSコード、ジェネリック | | トラブルシューティング | オフラインサーバー・PATH問題 | | セキュリティ | 安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安全・安心・安全・安心・安全・安心・安全・安全・安心・安全・安心・安全・安心・安全・安心・安全・安心・安全・安全・安心・安全・安全・安全・安心・安全・安心・安全・安全・安心・安心・安全・安全・安心・安心・安全・安心・安全・安心・安心・安心・安心・安全・安全・安心・安心・安心・安心・安全・安心・安心・安心・安心・安心・安心・安全・安心・安心・安心・安心・安心・安心・安心・安全・安心・安心・安心・安心・安心・安心・安全・安全・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安心・安全・安心・

GitHub ページ (オプション): docs/] を HTML として [docs/]] で [GitHub Actions** に設定します。

取得する

• MCP toolsによるライブキャプチャとpcap/pcapng解析
• MCP によるガイド付きワークフロー**
• Startup preflight:TSharkがなくなった場合、プロセスが終了し、ホストが壊れたツールリストの代わりにサーバーのオフライン/エラーが表示されます。
• [setup/[doctor]])CLIS なので、新しいユーザは推測せずにパスを構成することができます

要件

• Python 3.10+
• TShark([[T4])または[TSHARK_PATH)
• Npcap (Windows) または libpcap (Unix) を ** ライブ** キャプチャ
• ターゲットネットワーク上でキャプチャする認可

クイックスタート(5分)

Wireshark MCP Server

Packet capture and analysis for AI agents via the Model Context Protocol (MCP).

Works with any stdio MCP host: Cursor, Claude Desktop, Claude Code, VS Code / Copilot, Windsurf, custom agents, and similar tools. No vendor lock-in — the host only needs to launch:

python -m wireshark_mcp

Version 0.2.2

GitHub Pages (optional): set Settings → Pages → Source = GitHub Actions, then the Pages workflow publishes docs/ as HTML.

What you get

• Live capture and pcap/pcapng analysis through MCP tools
• Guided workflows via MCP prompts
• Startup preflight: if TShark is missing, the process exits so your host shows the server offline/error instead of a broken tool list
• setup / doctor CLIs so a new user can configure paths without guessing

Requirements

• Python 3.10+
• TShark (PATH or TSHARK_PATH)
• Npcap (Windows) or libpcap (Unix) for live capture
• Authorization to capture on the target network

Quick start (5 minutes)

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 detects TShark (or asks for its path) and writes or prints a standard mcpServers JSON block. Point your host at that config, then reload / restart the host.

Windows Wireshark install:

winget install --id WiresharkFoundation.Wireshark -e

MCP config (any host)

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

Windows example paths:

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

Ready-made template: examples/mcpServers.wireshark.json
Client-specific file locations: docs/Clients.md

CLI

Project layout

src/wireshark_mcp/     # MCP server package (tools, prompts, preflight)