网络分析工具包

Wireshark MCP Server是一个包含18种网络分析工具的专业套件,支持实时数据包捕获、PCAP文件操作和安全分析,适用于企业级网络监控和开发集成。

  • by LYFTIUM-INC
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 LYFTIUM-INC/wireshark-mcp

使用说明

🦈 Wireshark MCP服务器-生产就绪

专业的Wireshark MCP服务器,配备18个全面的网络分析工具,可与Claude Desktop集成。

🚀 特性

  • 18个完整的网络分析工具 -全面的数据包分析套件
  • 实时JSON流 -多种格式的实时数据包捕获
  • 先进的PCAP操作 -分割、合并、时间切片和转换文件
  • 证券分析 -威胁检测和异常分析
  • LLM电动过滤器生成 -Wireshark过滤器的自然语言
  • 企业就绪 -生产级错误处理和记录

📦 快速设置

先决条件

# Linux (Ubuntu/Debian)
sudo apt-get install wireshark tshark tcpdump python3-pip

# macOS  
brew install wireshark tcpdump python3

# Windows
choco install wireshark python3

安装

git clone https://github.com/priestlypython/wireshark-mcp.git
cd wireshark-mcp
pip install -r requirements.txt

# Configure permissions (Linux)
sudo usermod -a -G wireshark $USER
sudo setcap cap_net_raw,cap_net_admin=eip /usr/bin/dumpcap
newgrp wireshark

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "wireshark-mcp": {
      "command": "python",
      "args": ["/path/to/wireshark-mcp/enhanced_server.py"],
      "cwd": "/path/to/wireshark-mcp",
      "env": {
        "PYTHONPATH": "/path/to/wireshark-mcp",
        "WIRESHARK_PATH": "/usr/bin",
        "TSHARK_PATH": "/usr/bin/tshark",
        "TCPDUMP_PATH": "/usr/sbin/tcpdump"
      }
    }
  }
}

🛠️ 全部18个工具

岩心分析工具(8)

工具 目的 输出
wireshark_system_info 系统信息和接口 具有功能的JSON
wireshark_validate_setup 验证安装 依赖关系状态
wireshark_generate_filter AI滤镜生成 Wireshark显示滤镜
wireshark_live_capture 实时数据包捕获 数据包阵列
wireshark_analyze_pcap PCAP分析 综合统计数据
wireshark_realtime_json_capture JSON流 实时数据包
wireshark_protocol_statistics 协议分析 层次结构和对话
wireshark_analyze_pcap_enhanced 高级分析 安全与性能

高级工具(10)

工具 目的 输出
wireshark_pcap_time_slice 提取时间窗口 时间切片PCAP
wireshark_pcap_splitter 拆分PCAP文件 多个拆分文件
wireshark_pcap_merger 合并PCAP文件 合并的PCAP文件
wireshark_hex_to_pcap 将十六进制转换为PCAP PCAP文件
wireshark_http_analyzer HTTP流量分析 交易详情
wireshark_dns_analyzer DNS查询分析 查询模式和异常
wireshark_ssl_inspector SSL/TLS检查 证书和密码信息
wireshark_latency_profiler 性能分析 延迟指标
wireshark_threat_detector 安全分析 威胁评分和指标
wireshark_remote_capture SSH远程捕获 远程数据包

💡 使用示例

系统信息

# Check system capabilities
wireshark_system_info(info_type="all")
# → Returns interfaces, capabilities, server status

实时数据包捕获

# Capture HTTP traffic for 30 seconds
wireshark_live_capture(
    interface="eth0", 
    duration=30, 
    filter="tcp port 80",
    max_packets=1000
)
# → Returns captured packets with analysis

PCAP分析

# Comprehensive PCAP analysis
wireshark_analyze_pcap(
    filepath="/path/to/capture.pcap",
    analysis_type="comprehensive" 
)
# → File info, protocols, security analysis

过滤器生成

# Generate filter from natural language
wireshark_generate_filter(
    description="Show all HTTP traffic from 192.168.1.0/24",
    complexity="intermediate"
)
# → Returns optimized Wireshark filter

PCAP运营

# Split large PCAP by time
wireshark_pcap_time_slice(
    input_file="/path/to/large.pcap",
    start_time="2025-01-01T10:00:00",
    end_time="2025-01-01T11:00:00"
)
# → Creates time-sliced PCAP file

# Merge multiple PCAPs
wireshark_pcap_merger(
    input_files=["file1.pcap", "file2.pcap"],
    output_file="merged.pcap",
    sort_chronologically=true
)
# → Creates chronologically sorted merged file

证券分析

# Threat detection
wireshark_threat_detector(
    input_file="/path/to/suspicious.pcap",
    detection_mode="comprehensive",
    sensitivity="high"
)
# → Threat scores, anomalies, behavioral analysis

# DNS tunneling detection
wireshark_dns_analyzer(
    input_file="/path/to/capture.pcap",
    analysis_type="comprehensive",
    detect_tunneling=true
)
# → DNS patterns, suspicious domains, entropy analysis

🔧 预期产出

结构化JSON结果

所有工具都返回结构良好的JSON:

  • 状态指示器 (✅ 成功,❌ 错误)
  • 元数据 (文件大小、时间戳、统计数据)
  • 分析结果 (协议、对话、威胁)
  • 建议 (过滤建议、安全见解)

文件操作

PCAP操作工具创建格式正确的文件:

  • 带有精确时间戳的时间切片捕获
  • 使用有组织的命名约定拆分文件
  • 按时间顺序分组的合并文件
  • 转换后的文件保持数据包的完整性

安全情报

高级分析提供:

  • 威胁评分 (0-100风险评估)
  • 异常检测 (统计分析)
  • 模式识别 (攻击特征)
  • 行为分析 (网络健康指标)

🚨 故障排除

权限问题(常见)

# Linux: Set capabilities
sudo setcap cap_net_raw,cap_net_admin=eip /usr/bin/dumpcap
sudo usermod -a -G wireshark $USER

# macOS: Run Wireshark as admin once
sudo /Applications/Wireshark.app/Contents/MacOS/Wireshark

# Windows: Run as Administrator

未找到工具

  • 确保Wireshark已安装并处于PATH中
  • 检查 wireshark_validate_setup 缺少依赖项的工具
  • 验证Claude Desktop配置中的配置路径

未捕获任何数据包

  • 检查接口权限 wireshark_system_info
  • 验证所选接口上是否存在网络流量
  • 尝试不同的接口(eth0、wlan0、任意)

✅ 测试结果

最新测试日期: 2025-08-20
成功率:94.4%(17/18个工具完全可用)

类别 工具 状态
核心系统工具 3/3 ✅ 100%
捕获工具 2/2 ✅ 100%
分析工具 4/4 ✅ 100%
PCAP操纵 4/4 ✅ 100%
协议分析器 4/4 ✅ 100%
远程捕获 0/1 ⚠️ 需要SSH

看 WIRESHARK_MCP_TEST_REPORT.md 查看详细的测试结果。


📊 演出

  • 处理速率:10000+包/秒
  • 文件支持:带流媒体的多GB PCAP文件
  • 内存效率高:大文件的分块处理
  • 实时:亚秒级响应时间
  • 并发:支持多种分析操作
  • 平均响应:每次操作约300ms

🛡️ 安全

  • 安全权限:Linux功能而不是root
  • 进程隔离:沙盒子流程执行
  • 自动清理:使用后删除的临时文件
  • 审计日志:全面的操作日志记录
  • 错误处理:优雅的失败,信息丰富

📄 许可证

MIT许可证-请参阅 许可证 了解详情。


🦈 由人工智能驱动的专业网络分析。专为企业打造,专为开发人员设计。