使用说明
🦈 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许可证-请参阅 许可证 了解详情。
🦈 由人工智能驱动的专业网络分析。专为企业打造,专为开发人员设计。
