MCP 使用说明

01 MCP 是什么

MCP（Model Context Protocol，模型上下文协议）是一种连接 AI 客户端与本地应用的标准协议。

启用 Packet Capture Pro MCP 服务后，支持 MCP 的 AI 客户端可以在获得授权后，读取和操作 Packet Capture Pro 中的数据。用户可以通过自然语言让 AI 客户端完成以下操作：

• 查看和筛选实时抓包数据。
• 查看和筛选历史记录。
• 根据记录生成 cURL 或 HAR。
• 创建、修改、启用或删除重写规则。
• 执行普通重放和高级重放。
• 创建并执行调试内容。
• 导入和分析 HAR 文件。

AI 客户端会根据用户提出的要求，选择并调用 Packet Capture Pro 提供的 MCP Tools。

02 PC 端与移动端的区别

03 PC 端使用条件

使用 PC 端 MCP 前，请确认：

1. Packet Capture Pro 已升级到支持 MCP 的版本（3.0.0及以上版本）。
2. 使用的 AI 客户端支持本地 stdio 类型的 MCP Server。
3. Packet Capture Pro 的 MCP 服务已经开启。
4. 已将 Packet Capture Pro MCP Server 配置到 AI 客户端。
5. 首次连接时，已在 Packet Capture Pro 中允许该 AI 客户端连接。

04 打开 PC 端 MCP 服务

1. 打开 Packet Capture Pro。
2. 在左侧导航栏中选择“MCP”。
3. 打开“MCP 服务”页面。
4. 开启“MCP 服务”。
5. 点击“配置 AI 客户端”，按照页面说明完成配置。

开启 MCP 服务后，Packet Capture Pro 开始接受本机 AI 客户端发起的连接请求。开启服务本身不会立即向 AI 客户端发送数据；用户仍需完成客户端配置，并在首次连接时允许该客户端连接。

05 PC 端连接状态

MCP 服务页面会显示当前连接状态和已经连接的 AI 客户端。

06 PC 端首次连接授权

新的 AI 客户端首次请求连接 Packet Capture Pro 时，需要由用户决定是否允许连接。

• 允许连接后，该客户端可以发现并调用 Packet Capture Pro 当前开放的 MCP Tools。
• 拒绝连接后，该客户端无法读取或操作 Packet Capture Pro 中的数据。
• AI 客户端自身可能具有 Tool 调用确认、安全审批或自动执行设置，这些设置由对应 AI 客户端控制，不受 Packet Capture Pro 控制。

07 配置 PC 端 AI 客户端

在“配置 AI 客户端”页面选择需要使用的客户端，按照页面提供的配置命令或配置文件内容，将 Packet Capture Pro MCP Server 添加到 AI 客户端。

配置时通常需要使用 Packet Capture Pro 页面中显示的 MCP Server 可执行文件路径。不同 AI 客户端的配置入口和格式可能不同，请以 Packet Capture Pro 页面中展示的最新说明为准。

支持的客户端包括：

• Claude Code
• Cursor
• Codex
• TRAE
• 其他支持本地 stdio MCP Server 的 AI 客户端

08 PC 端敏感数据保护

敏感数据保护用于降低抓包数据中的认证信息被直接发送给 AI 客户端的风险。

开启后，Packet Capture Pro 会在通过 MCP 向 AI 客户端返回数据前，自动处理以下字段：

敏感数据保护只影响通过 MCP 返回给 AI 客户端的数据，不会修改 Packet Capture Pro 中保存的原始抓包数据。用户仍然可以在 Packet Capture Pro 中查看未经修改的原始内容。

关闭敏感数据保护后，Packet Capture Pro 通过 MCP 返回数据时，将不再自动隐藏上述敏感字段。关闭前请确认连接的是可信 AI 客户端，并确认相关数据允许发送。

09 关闭 PC 端 MCP 服务

关闭 MCP 服务后：

• 所有已连接的 AI 客户端将断开连接。
• AI 客户端无法继续读取 Packet Capture Pro 中的数据。
• AI 客户端无法继续调用 Packet Capture Pro 提供的 MCP Tools。
• 正在等待结果的 MCP 调用可能被终止或返回连接失败。
• 已经完成的删除、清空、重写、重放等操作不会自动撤销。

10 移动端使用条件

使用移动端 MCP 前，请确认：

1. Packet Capture Pro 移动端已升级到支持 MCP 的版本（5.6.0及以上版本）。
2. 当前账号具有 MCP 功能使用权限。
3. 手机与运行 AI 客户端的电脑连接在同一局域网。
4. AI 客户端支持通过 HTTP 添加远程 MCP Server。
5. 移动端 Packet Capture Pro 的 MCP 服务已经开启。
6. 已在 AI 客户端中配置移动端显示的 MCP 服务地址和访问令牌。

11 打开移动端 MCP 服务

1. 打开 Packet Capture Pro 移动端。
2. 打开侧边栏，点击“MCP”。
3. 开启“MCP 服务”。
4. 查看当前 MCP 服务地址和访问令牌。
5. 点击“配置 AI 客户端”。
6. 选择需要使用的 AI 客户端，复制并完成对应配置。

开启服务后，移动端会在当前局域网中启动 HTTP MCP Server。AI 客户端需要携带正确的访问令牌才能发现和调用 Tools。

12 移动端 MCP 服务地址与端口

端口规则

• 默认端口：19027。
• 可设置范围：1024–65535。
• 端口只能输入整数。
• 修改端口后，服务地址会发生变化，AI 客户端需要使用新地址重新配置。

网络变化

手机切换 Wi-Fi、重新连接网络或局域网 IP 发生变化后，原 MCP 服务地址可能失效。Packet Capture Pro 会根据当前网络生成新的服务地址，需要复制新的服务地址并重新配置 AI 客户端。

13 移动端访问令牌

访问令牌用于验证连接移动端 MCP 服务的 AI 客户端身份。

令牌规则

• 访问令牌由 Packet Capture Pro 使用安全随机方式生成。
• 令牌不包含账号、设备、IP 地址等可推测信息。
• 首次开启 MCP 服务时自动生成访问令牌。
• 可以点击复制按钮复制完整令牌。
• 不要通过公开截图、聊天或邮件分享令牌。
• 访问令牌仅用于身份认证。

刷新访问令牌

点击刷新按钮并确认后，Packet Capture Pro 会生成新的访问令牌：

• 当前访问令牌立即失效。
• 使用旧令牌建立的连接将断开。
• 已配置的 AI 客户端需要使用新令牌重新配置。

14 移动端敏感数据保护

敏感数据保护用于降低抓包数据中的认证信息被直接发送给 AI 客户端的风险。

开启后，Packet Capture Pro 会在数据返回 AI 客户端前自动处理以下字段：

敏感数据保护只影响通过 MCP 返回给 AI 客户端的数据，不会修改 Packet Capture Pro 中保存的原始抓包数据。

15 配置移动端 AI 客户端

在“配置 AI 客户端”页面选择需要使用的客户端。

可选择：

• Claude Code
• Cursor
• Codex
• TRAE
• 其他 AI 客户端

16 协同模式下的限制

协同模式和 MCP 服务可以同时开启，但协同模式开启后，抓包数据保存在电脑端，暂不支持通过移动端 MCP 查询和操作。

17 关闭移动端 MCP 服务

关闭移动端 MCP 服务后：

• 停止接受新的 MCP 连接。
• 已连接的 AI 客户端断开连接。
• 正在执行或等待的 MCP 调用可能被终止。
• 不影响 Packet Capture Pro 自身的抓包及其他非 MCP 功能。

再次开启 MCP 服务后，如果服务地址或访问令牌已经发生变化，需要重新配置 AI 客户端。

18 MCP Tool 清单

PC 端与移动端分别注册当前版本实际支持的 Tools。相同能力使用一致的 Tool 名称、参数和返回结构，但两端的 Tool 数量和功能范围不同。AI 客户端实际发现的 Tool 清单即为当前平台的可用范围。

18.1 PC 端支持的 MCP Tools

PC 端连接成功后，AI 客户端可以发现并调用以下 Tools：

18.2 移动端支持的 MCP Tools

当前版本的移动端 MCP 仅支持实时抓包和历史记录相关能力。连接成功后，AI 客户端可以发现并调用以下 Tools：

19 Tool 执行规则

Packet Capture Pro 采用“Tool 能力即开放能力”的设计：

• AI 客户端只能调用当前连接中实际注册的 Tools。
• Tool 执行前会校验参数完整性、目标对象、文件访问范围和并发限制。
• 参数无效、目标不存在或执行失败时，会向 AI 客户端返回明确错误。
• AI 客户端自身的 Tool 审批机制仍然可能要求用户确认。
• 删除、清空、重放和重写等操作完成后，不会因停用规则、关闭 MCP 或断开连接而自动回滚。
• MCP 服务关闭、授权失效或连接断开后，等待类任务会被终止。

20 安全与隐私注意事项

• 请只允许可信的 AI 客户端连接 Packet Capture Pro。
• AI 客户端自身可能在调用 Tool 前要求确认。
• 不同 AI 客户端的 MCP 配置方式、Tool 确认方式和超时限制可能不同。
• AI 客户端能否完成多步骤任务，还会受到模型能力、上下文长度和任务执行限制的影响。
• 移动端服务地址和访问令牌属于敏感连接信息，不要公开分享。
• 不建议在公共 Wi-Fi 或不可信局域网中开启移动端 MCP 服务。

PC 端常见问题

21 AI 客户端无法连接 PC 端 MCP

请依次检查：

1. PC 端 Packet Capture Pro 是否正在运行。
2. Packet Capture Pro 中的 MCP 服务是否已经开启。
3. 使用的 AI 客户端是否支持本地 stdio 类型的 MCP Server。
4. 配置内容中是否存在多余的引号、空格、换行或转义字符。

22 首次连接时没有出现授权提示

请确认 AI 客户端已经发起连接，如果 AI 客户端尚未成功启动 MCP Server，Packet Capture Pro 不会显示授权提示。

可以尝试：

1. 保持 Packet Capture Pro 运行并开启 MCP 服务。
2. 检查 AI 客户端中的 MCP 配置是否已启用。
3. 重新加载或重启 AI 客户端，使其再次发起连接。
4. 仍未出现提示时，删除 AI 客户端中的旧配置，然后按照 Packet Capture Pro 页面提供的最新内容重新配置。

23 PC 端连接突然中断

以下情况会导致连接中断：

• Packet Capture Pro 被退出或异常关闭。
• Packet Capture Pro 中的 MCP 服务被关闭。
• AI 客户端被退出、重启或重新加载配置。
• 电脑休眠、用户退出登录或相关进程被系统终止。

24 PC 端可以连接，但无法查询或操作数据

请确认当前 PC 端 Packet Capture Pro 中存在可查询的数据。

Tool 调用还可能因为以下原因失败：

• Tool 参数不完整或格式错误。
• 指定的抓包记录、历史记录或规则已经不存在。
• 当前业务状态不允许执行该操作。
• 文件路径超出允许访问的范围。
• 操作超时或超过并发限制。
• AI 客户端未批准本次 Tool 调用。

25 多个 AI 客户端可以同时连接吗

支持多个客户端同时连接，多个客户端同时执行修改、删除、清空、重写或重放操作时，可能出现目标状态变化或操作冲突。

建议同一时间仅由一个可信客户端执行写入类操作；其他客户端可用于查询和分析。

移动端常见问题

26 AI 客户端无法连接移动端 MCP

请依次检查：

1. 移动端 MCP 服务是否已经开启。
2. 手机与电脑是否连接同一局域网。
3. AI 客户端是否支持 HTTP MCP Server。
4. MCP 服务地址是否与移动端当前显示的地址一致。
5. 访问令牌是否完整，前面是否包含 Bearer 。
6. 设置的端口是否在 1024–65535 范围内且未被占用。
7. 路由器是否开启了 AP 隔离、访客网络隔离或设备隔离。
8. 移动端 App 是否仍处于可运行状态。

27 原来的移动端服务地址突然无法使用

手机切换网络、重新连接 Wi-Fi 或重新获取 IP 后，服务地址可能发生变化。请进入移动端 MCP 页面，复制最新服务地址并重新配置 AI 客户端。

28 可以连接，但无法查询移动端抓包数据

请检查是否开启了协同模式。协同模式下，抓包数据保存在电脑端，暂不支持通过移动端 MCP 查询和操作。

29 关闭 App 或进入后台后连接中断

Packet Capture Pro 无法运行时，移动端 MCP 服务也不可用。请重新打开 Packet Capture Pro，并确认 MCP 服务状态和服务地址。