TShark2MCP - AI 辅助报文分析的 MCP 协议工具

基于 Wireshark 的 TShark 命令行工具，构建一个支持 Model Context Protocol (MCP) 的 AI 辅助报文分析服务器，让 AI 助手能够通过标准化的 MCP 协议调用报文提取工具，辅助用户快速定位和分析网络通信异常。

功能概述

提供6个核心报文分析工具，支持：

pcap 文件概览分析
网络会话提取
时间范围过滤
协议类型过滤
特定网络流分析
统计指标计算

环境要求

Python 3.8+
Wireshark/TShark 4.0+

安装步骤

1. 安装 Wireshark

Windows:

下载并安装 Wireshark
确保 TShark 被添加到系统 PATH，或记录安装路径

2. 安装 Python 依赖

pip install -r requirements.txt

MCP 服务器配置

将以下配置添加到支持 MCP 协议的 AI 助手（如 Cursor、VS Code、Claude Desktop）中：

{
  "mcpServers": {
    "tshark2mcp": {
      "command": "python",
      "args": [
        "D:\\niusulong\\wireshark_mcp\\TShark2MCP\\main.py"
      ],
      "env": {
        "PYTHONPATH": "D:\\niusulong\\wireshark_mcp\\TShark2MCP\\src",
        "TSHARK_PATH": "C:\\Program Files\\Wireshark\\tshark.exe"
      }
    }
  }
}

配置说明

command: 启动服务器的命令（python）
args: 服务器入口文件的绝对路径
env: 环境变量配置
- PYTHONPATH: 确保 Python 能找到项目模块
- TSHARK_PATH: TShark 可执行文件路径

重要: 请根据实际安装路径修改 args 和 TSHARK_PATH 的值。

TShark 路径配置

项目支持多种 TShark 路径配置方式，按优先级排序：

环境变量 TSHARK_PATH (推荐)

export TSHARK_PATH="C:\Program Files\Wireshark\tshark.exe"

系统 PATH 中的 tshark
- 确保 Wireshark 安装时添加到系统 PATH
自动检测 (备用)
- 项目会尝试在常见位置查找 TShark

启动服务器

python main.py

贡献

欢迎提交 Issue 和 Pull Request 来改进项目。

许可证

[项目许可证]

TShark2MCP