一.前置要求

在部署 WireMCP + CodeBuddy AI 自动分析 PCAP 数据包 环境前，请提前核对并满足以下系统条件，避免后续安装、运行报错：

1. 操作系统：Windows 10 / Windows 11 全系版本
2. 权限要求：电脑管理员权限（用于软件安装、环境变量配置、服务运行）
3. 网络要求：稳定外网网络（用于拉取 WireMCP 依赖、CodeBuddy 联网交互）

二.安装wireshark

步骤 1：下载安装包

1. 访问 Wireshark 官方下载页
2. 选择 Windows 64 位安装程序，下载.exe安装包
3. 右键安装包，选择以管理员身份运行

步骤 2：安装关键勾选（必选，缺失会导致 tshark 无法调用）

跟随安装向导下一步，到组件选择页面，务必勾选 3 项：

• ✅ Install Npcap（网卡抓包驱动，无则无法捕获实时流量）
• ✅ Install USBPcap（USB 流量抓包拓展，可选但建议勾选）
• ✅ Add Wireshark to the system PATH（自动配置环境变量，跳过手动配置）

其余组件保持默认，一路完成安装。

步骤 3：验证 tshark 是否生效

1. 关闭所有已打开的 CMD/PowerShell，重新新建终端窗口（环境变量刷新）
2. 执行验证命令：

tshark --version

1. 输出版本号即安装成功；提示 “不是内部命令” 则手动添加 Wireshark 环境变量，后文排错章节会讲解。

3. 当前内容校验总结

✅ 步骤逻辑正确，安装勾选项无错误； ❌ 缺少说明：为什么必须装 Wireshark——WireMCP 依赖tshark实现 PCAP 离线解析、实时流量抓取，没有 Wireshark 整套工具链，WireMCP 完全无法分析抓包文件。

三.安装node.js

WireMCP 基于 Node.js 开发，必须安装 v18+ LTS 长期支持版 才能正常运行、解析 PCAP 数据包，是必不可少的运行依赖。

步骤 1：下载安装包

1. 访问 Node.js 官方下载地址
2. 下载 Windows LTS 稳定版（推荐 v18 /v20，不建议最新尝鲜版）
3. 选择后缀为 .msi 的 Windows 安装程序

步骤 2：安装配置

1. 右键安装包，以管理员身份运行
2. 全程默认下一步，务必保证勾选 Add to PATH（自动写入系统环境变量，无需手动配置）
3. 直接完成安装即可

步骤 3：验证是否安装成功

⚠️ 必须关闭旧 CMD/PowerShell，重新打开新终端，否则环境变量不生效 依次输入两条校验命令：

cmd

node --version
npm --version

终端正常输出版本号即代表安装成功；提示不是内部命令则说明环境变量未生效，需重启电脑或手动配置 PATH。

四、下载并部署 WireMCP 服务（PCAP AI 解析核心）

WireMCP 是基于 tshark 的 MCP 协议服务，作用是打通 CodeBuddy 与本地抓包工具，让 AI 可以自动读取、解析、分析 PCAP 流量包、检测网络威胁、提取报文信息。

步骤 1：创建本地工作目录

在电脑任意磁盘创建文件夹，推荐固定路径：C:\WireMCP 打开 CMD / PowerShell，进入该目录：

cmd

cd C:\WireMCP

步骤 2：克隆官方源码仓库

执行 git 克隆命令，直接拉取源码到当前目录：

cmd

git clone https://github.com/0xkoda/WireMCP.git .

无 Git 环境解决方案：

1. 前往 WireMCP 官方 GitHub 地址，下载源码 ZIP 压缩包
2. 解压所有文件到 C:\WireMCP 目录下（保证 index.js 在根目录）

步骤 3：安装项目依赖

在当前目录执行依赖安装命令：

cmd

npm install

等待所有依赖自动安装完成，无报错即可。

步骤 4：本地测试 WireMCP 服务启动

执行启动命令，测试服务可用性：

cmd

node index.js

终端输出 MCP Server started 类似启动日志，代表 WireMCP 部署成功。 测试完成后按下 Ctrl + C 停止服务，后续交由 CodeBuddy 自动调用。

五.配置CodeBuddy

前面所有环境都是为了这一步！WireMCP 必须接入 CodeBuddy 的 MCP 协议，才能让 AI 自动读取、解析、分析 PCAP 抓包文件、实时抓包、威胁检测。

⚠️ 重要区别：网上绝大多数教程都是 Cursor 配置，和 CodeBuddy 不通用，路径、配置文件完全不一样，本文为 CodeBuddy 专属正确配置。

步骤1：找到 CodeBuddy 专属 MCP 配置文件

CodeBuddy 的 MCP 配置文件固定位置：

C:\Users\你的用户名\.codebuddy\.mcp.json

快速打开方式：

1. Win + R

2. 输入 %userprofile% 回车

3. 进入 .codebuddy 隐藏文件夹

4. 查看是否存在.mcp.json

如果没有该文件，手动新建文本文档，重命名为 .mcp.json（注意开启文件扩展名显示）。

步骤2：写入 WireMCP 完整配置（100% 可用模板）

打开.mcp.json，粘贴以下配置，仅需修改本地 WireMCP 路径：

{
  "mcpServers": {
    "wiremcp": {
      "command": "node",
      "args": [
        "C:\\WireMCP\\index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

关键避坑说明（必看）

• Windows 路径必须使用 双反斜杠 \\，单斜杠会直接报错无法连接

• 路径必须指向 index.js，不能只写到文件夹

• 文件名必须是 .mcp.json，不能是 mcp.json、.mcp.json.txt

• 必须保存为 UTF-8 编码，否则 CodeBuddy 读取配置乱码

步骤3：重启 CodeBuddy 加载 MCP 服务

1. 完全关闭 VS Code / IDEA 等搭载 CodeBuddy 的编辑器

2. 重新打开编辑器

3. CodeBuddy 会自动扫描并后台挂载 WireMCP MCP 服务

六、配置验证：确认 WireMCP 成功挂载

验证方式一：服务自检

终端手动执行：

node C:\WireMCP\index.js

输出 MCP Server started 说明服务本体无问题。

验证方式二：AI 功能测试（核心）

打开 CodeBuddy 对话窗口，直接发送测试指令：

检测当前WireMCP服务是否正常连接，并列出当前可用的网络分析工具

正常情况下 AI 会自动识别出：capture_packets、analyze_pcap、check_threats 等工具，代表配置彻底成功。