基于 Wireshark 库构建的原生 macOS 抓包查看器,是 Wireshark 的更简洁替代品。
- Star
- 371
- Fork
- 47
- 未关闭 Issue
- 5
- 最近提交
- 6天前
这是什么?
Wireshark MCP 是一个 MCP 服务器,把 tshark 及部分 Wireshark 套件工具封装成结构化的分析接口。用户在支持 MCP 的 AI 客户端(如 Claude Desktop、Claude Code、Cursor、VS Code)中指定抓包文件,用自然语言提问,助手通过调用工具运行 tshark 并基于其输出作答。
默认配置提供 54 个工具,涵盖数据包列表与详情、HTTP 和 DNS 提取、聚合统计,以及端口扫描、DNS 隧道、心跳通信、数据外传和 ARP 欺骗等安全检测。协议分析工具可针对 25 种协议自动选用正确的字段和显示过滤器。检测结果采用统一的 finding 格式,包含证据锚点和可用于复核的 tshark 命令。可选的 DuckDB 抓包索引能加速大文件上的重复查询,案例文件则可在多次会话间保存调查的发现与结论。
工具输出有长度上限,每个工具还声明读写属性,便于客户端自动批准只读分析操作。会写文件的工具和远程 HTTP 绑定受允许目录与本地回环默认配置的限制。项目可通过 PyPI 安装并交互式配置客户端,也提供 Claude Code 和 Codex 插件安装方式。
核心功能
- 01提供 54 个 MCP 工具,基于 tshark 输出完成数据包、流、统计和安全分析。
- 02通过一个协议分析工具覆盖 25 种协议,自动选用对应字段和显示过滤器。
- 03内置 DNS 隧道、端口扫描、心跳通信、数据外传和 ARP 欺骗等检测器。
- 04可选的 DuckDB 抓包索引,加速大型抓包文件的查询。
- 05调查的发现和结论保存在 JSON 案例文件中,可跨会话延续。
- 06提供精简配置档,减少每次请求的工具列表开销。
适用场景
- 让 AI 助手快速筛查 pcap 文件中的可疑 DNS、HTTP 或凭据类流量。
- 查找某个主机首次出现的时间,或比较两个抓包之间的流量变化。
- 借助正确的字段名分析 Modbus、S7comm、Zigbee、BLE 等工业或无线协议。
- 开展需要持续记录发现并跨会话恢复的长期事件调查。
快速上手
- 1
安装 Wireshark(包含 tshark)并确保 tshark 在 PATH 中
- 2
从 PyPI 安装 Python 包
pip install wireshark-mcp - 3
在你的 MCP 客户端中注册该服务(从检测到的客户端中选择)
wireshark-mcp install
使用前须知
- 需要单独安装带 tshark 的 Wireshark,本包不会自动安装它。
- 在 WIRESHARK_MCP_ALLOWED_DIRS 指定已存在的目录之前,文件读取和写入相关工具会默认拒绝执行。
收录于专题
标签
常见问题
- Wireshark-MCP 是什么?
- 一个 MCP 服务器,让 AI 助手通过 tshark 直接分析 pcap 抓包文件,回答基于真实数据。 Wireshark MCP 是一个 MCP 服务器,把 tshark 及部分 Wireshark 套件工具封装成结构化的分析接口。用户在支持 MCP 的 AI 客户端(如 Claude Desktop、Claude Code、Cursor、VS Code)中指定抓包文件,用自然语言提问,助手通过调用工具运行 tshark 并基于其输出作答。
- Wireshark-MCP 可以免费使用吗?用的什么许可证?
- Wireshark-MCP 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- Wireshark-MCP 还在维护吗?
- 活跃维护中。Wireshark-MCP 最近一次提交是在 2026年11月1日。
- Wireshark-MCP 适合用来做什么?
- 让 AI 助手快速筛查 pcap 文件中的可疑 DNS、HTTP 或凭据类流量。 查找某个主机首次出现的时间,或比较两个抓包之间的流量变化。 借助正确的字段名分析 Modbus、S7comm、Zigbee、BLE 等工业或无线协议。 开展需要持续记录发现并跨会话恢复的长期事件调查。
- Wireshark-MCP 怎么安装和运行?
- 安装 Wireshark(包含 tshark)并确保 tshark 在 PATH 中 从 PyPI 安装 Python 包: pip install wireshark-mcp 在你的 MCP 客户端中注册该服务(从检测到的客户端中选择): wireshark-mcp install
- 在哪里获取 Wireshark-MCP?
- 源代码和安装说明在 GitHub 上:https://github.com/bx33661/Wireshark-MCP
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
无需 root 的 Android 应用,可监控、拦截并录制各应用的网络流量为 PCAP 文件。
基于 eBPF 的 Kubernetes 网络可观测工具,索引集群流量、解密 TLS,并可通过 MCP 供 AI 代理查询。
跨平台桌面应用,用于实时监控网络流量、检查连接并导出 PCAP 抓包文件。
让 AI 智能体调用 Shodan API 与 CVEDB 的 MCP 服务,用于联网设备搜索、主机侦察、DNS 与 CVE 情报查询。
基于 Go 的可扩展安全框架,用于 WiFi、BLE、HID、CAN 总线和 IPv4/IPv6 网络的侦察与中间人攻击测试。