Repolode
bx33661

bx33661/Wireshark-MCP

一个 MCP 服务器,让 AI 助手通过 tshark 直接分析 pcap 抓包文件,回答基于真实数据。

可替代: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. 1

    安装 Wireshark(包含 tshark)并确保 tshark 在 PATH 中

  2. 2

    从 PyPI 安装 Python 包

    pip install wireshark-mcp
  3. 3

    在你的 MCP 客户端中注册该服务(从检测到的客户端中选择)

    wireshark-mcp install

使用前须知

  • 需要单独安装带 tshark 的 Wireshark,本包不会自动安装它。
  • 在 WIRESHARK_MCP_ALLOWED_DIRS 指定已存在的目录之前,文件读取和写入相关工具会默认拒绝执行。

收录于专题

标签

#mcp#packet-analysis#tshark#network-security#pcap#wireshark#ai-agents

常见问题

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 数据每日更新。

相关项目