MCP Wireshark

Name: MCP Wireshark
Author: khuynh22

@khuynh22

关于 MCP Wireshark

An MCP server that integrates Wireshark/tshark with AI tools and IDEs. Capture live traffic, parse .pcap files, apply display filters, follow streams, and export JSON - all via Claude Desktop, VS Code, or CLI. Cross‑platform, typed, tested, and pip‑installable.

#wireshark #tshark #network #pcap #packet-capture #network-analysis #security #iec61850

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

khuynh22

提交者

Khang Nguyen Huynh

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "wireshark": {
      "command": "mcp-wireshark",
      "args": []
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Wireshark?

MCP Wireshark is a community-maintained MCP server that gives AI assistants direct access to Wireshark/tshark packet captures. It allows users to summarize .pcap files, follow TCP streams, filter for specific protocols, and capture live traffic without leaving the chat.

How to use MCP Wireshark?

Install the package with pip install mcp-wireshark and add it to Claude Code using claude mcp add --transport stdio --scope user mcp-wireshark -- mcp-wireshark. The server works with any MCP client (Claude Desktop, VS Code, Cursor, etc.) and requires tshark to be installed and on the system PATH.

Key features of MCP Wireshark

14 tools split into read and write categories
Read tools: summarize_pcap, display_filter, follow_tcp/udp, expert_info, decode_protocol, analyze_iec61850, and more
Write tools: live_capture (capped at 5 min / 10k packets) and export_json
All read tools annotated with MCP readOnlyHint for safety
Security: file path validation, no shell metacharacters, no shell=True, hard caps on packets and time
Supports IEC 61850 analysis (GOOSE, SV, MMS)

Use cases of MCP Wireshark

Summarize an unknown packet capture to see I/O stats, protocol hierarchy, and top talkers
Follow a TCP or UDP stream and extract its payload
Filter a capture with Wireshark display filters for specific protocols (HTTP, DNS, TLS, etc.)
Capture live traffic from a network interface with a display filter
Export packets from a pcap to a JSON file for further analysis

FAQ from MCP Wireshark

What prerequisites are required to run MCP Wireshark?

Python 3.10+ and Wireshark installed with tshark reachable on the system PATH.

How can I verify the installation?

Inside Claude Code, ask the assistant to "Run check_installation." If tshark is on the PATH, it returns the version.

How do I capture live traffic with MCP Wireshark?

Use the live_capture tool. It captures traffic from a specified interface, capped at 5 minutes or 10,000 packets, and can be combined with a display filter.

What should I do if `tshark` is not found on Windows?

Add the Wireshark installation directory (e.g., C:\Program Files\Wireshark) to the system PATH environment variable, then restart the terminal and Claude Code.