MCP 使用说明
连接支持 MCP 的 AI 客户端，在获得授权后读取和操作 Packet Capture Pro 中的数据。
01MCP 是什么
MCP（Model Context Protocol，模型上下文协议）是一种连接 AI 客户端与本地应用的标准协议。
启用 Packet Capture Pro MCP 服务后，支持 MCP 的 AI 客户端可以在获得连接授权后，读取和操作 Packet Capture Pro 中的数据。通过 MCP，用户可以使用自然语言让 AI 客户端完成以下操作：
- 查看和筛选实时抓包数据。
- 查看和筛选历史记录。
- 创建、修改、启用或删除重写规则。
- 执行普通重放和高级重放。
- 创建并执行调试内容。
- 导入和分析 HAR 文件。
02使用条件
使用 Packet Capture Pro MCP 功能前，请确认：
- Packet Capture Pro 已升级到支持 MCP 的版本（3.0.0及以上版本）。
- 使用的 AI 客户端支持本地 stdio 类型的 MCP Server。
- Packet Capture Pro 的 MCP 服务已经开启。
- 已将 Packet Capture Pro MCP Server 配置到 AI 客户端。
- 首次连接时，已在 Packet Capture Pro 中允许该 AI 客户端连接。
03打开 MCP 服务
04MCP 服务开关
4.1 开启 MCP 服务
开启“MCP 服务”后，Packet Capture Pro 开始接受 AI 客户端发起的 MCP 连接请求。
开启 MCP 服务本身不会立即向 AI 客户端发送数据。用户还需要完成 AI 客户端配置，并在首次连接时允许该客户端连接。连接成功后，AI 客户端可以发现并调用 Packet Capture Pro 的 MCP Tools。
4.2 关闭 MCP 服务
关闭 MCP 服务后：
- 所有已连接的 AI 客户端将断开连接。
- AI 客户端无法继续读取 Packet Capture Pro 中的数据。
- AI 客户端无法继续调用 Packet Capture Pro 提供的 MCP Tools。
- 正在等待结果的 MCP 调用可能被终止或返回连接失败。
05连接状态
MCP 服务页面显示当前连接状态。“连接客户端”区域显示当前已经连接的 AI 客户端名称。
| 状态 | 说明 |
|---|---|
| 未连接 | MCP 服务已开启，但当前没有 AI 客户端连接 |
| 正在连接 | AI 客户端正在与 Packet Capture Pro 建立连接 |
| 已连接 | AI 客户端已经连接，可以调用 Packet Capture Pro 提供的 Tools |
06首次连接授权
新的 AI 客户端首次请求连接 Packet Capture Pro 时，需要由用户决定是否允许连接。用户允许连接后，该客户端可以调用 Packet Capture Pro 全部 MCP Tools。
AI 客户端自身可能具有 Tool 调用确认、安全审批或自动执行设置，这些设置由对应 AI 客户端控制，不受 Packet Capture Pro 控制。
07敏感数据保护
敏感数据保护用于降低抓包数据中的认证信息被直接发送给 AI 客户端的风险。
开启后，Packet Capture Pro 在向 AI 客户端返回数据前，会识别并隐藏以下敏感信息：
| 数据类型 | 默认处理方式 |
|---|---|
Authorization | 保留字段名称，隐藏字段值 |
Cookie / Set-Cookie | 保留 Cookie 名称，隐藏对应值 |
Token | 匹配常见 Header 隐藏值 |
敏感数据保护只影响通过 MCP 返回给 AI 客户端的数据，不会修改 Packet Capture Pro 中保存的原始抓包数据。关闭保护后，返回数据时将不再自动隐藏上述敏感字段。
08配置 AI 客户端
选择需要连接的 AI 客户端后，Packet Capture Pro 会展示对应的配置方式和 MCP Server 可执行文件路径。
请按照页面提供的配置说明，将 Packet Capture Pro MCP Server 添加到对应的 AI 客户端。
09MCP Tool 清单
连接成功后，AI 客户端可以发现并调用以下 Packet Capture Pro Tools。
| 分组 | Tool | 功能 |
|---|---|---|
| 实时抓包 | pcp_capture_live_get_status | 获取实时抓包状态 |
| 实时抓包 | pcp_capture_live_set_enabled | 启动或停止实时抓包 |
| 实时抓包 | pcp_capture_live_filter | 根据条件筛选实时抓包记录 |
| 实时抓包 | pcp_capture_live_get_by_id | 根据 ID 获取实时抓包详情 |
| 实时抓包 | pcp_capture_live_generate_curl | 根据记录生成 cURL |
| 实时抓包 | pcp_capture_live_generate_har | 根据记录生成 HAR |
| 实时抓包 | pcp_capture_live_delete | 根据 ID 删除指定实时记录 |
| 实时抓包 | pcp_capture_live_clear | 清空实时抓包记录 |
| 实时抓包 | pcp_capture_live_wait_for_match | 等待符合条件的新抓包记录 |
| 历史记录 | pcp_capture_history_filter | 根据条件筛选历史记录 |
| 历史记录 | pcp_capture_history_get_by_id | 根据 ID 获取历史记录详情 |
| 历史记录 | pcp_capture_history_generate_curl | 根据历史记录生成 cURL |
| 历史记录 | pcp_capture_history_generate_har | 根据历史记录生成 HAR |
| 历史记录 | pcp_capture_history_delete | 删除指定历史记录 |
| 历史记录 | pcp_capture_history_clear | 清空历史记录 |
| 重写 | pcp_rewrite_list | 获取重写规则列表 |
| 重写 | pcp_rewrite_get_by_id | 根据 ID 获取重写规则内容 |
| 重写 | pcp_rewrite_create | 创建重写规则（新建或从抓包数据中带入） |
| 重写 | pcp_rewrite_update | 修改指定重写规则 |
| 重写 | pcp_rewrite_set_enabled | 选中或取消指定重写规则 |
| 重写 | pcp_rewrite_delete | 删除指定重写规则 |
| 重放 | pcp_replay_execute | 按原始请求内容执行重放 |
| 重放 | pcp_replay_get_result | 获取重放结果 |
| 高级重放 | pcp_advanced_replay_execute | 配置高级重放参数后执行（实时抓包和历史记录） |
| 高级重放 | pcp_advanced_replay_get_result | 获取高级重放结果 |
| 调试 | pcp_debug_create | 创建调试内容（新建或从抓包数据中带入） |
| 调试 | pcp_debug_update | 修改调试内容 |
| 调试 | pcp_debug_execute | 执行调试 |
| 调试 | pcp_debug_get_result | 获取调试结果和过程信息 |
| 调试 | pcp_debug_delete | 删除指定调试 |
| 导入 | pcp_import_file | 导入 HAR 文件 |
| 导入 | pcp_import_get_result | 获取导入结果 |
| 导入 | pcp_import_get_by_id | 根据 ID 获取导入详情 |
10Tool 执行规则
Packet Capture Pro 采用“Tool 能力即开放能力”的设计。
- Tool 清单中的能力可以被已授权连接的 AI 客户端调用。
- 用户不能单独开启或关闭某一个 Tool。
- Packet Capture Pro 不对每一次 Tool 调用重复显示确认。
- Tool 执行前会校验参数完整性、目标对象、文件访问范围和并发限制。
- Tool 参数无效、目标不存在或执行失败时，会向 AI 客户端返回明确错误。
- AI 客户端自身的 Tool 审批机制仍然可能要求用户确认。
- 删除、清空、重放和重写等操作产生的结果，不会因为后续停用规则或断开 MCP 连接而自动回滚。
11使用注意事项
- MCP Tools 可以执行抓包、重写、重放、删除、调试和文件导入等实际操作。
- 请只允许可信的 AI 客户端连接 Packet Capture Pro。
- 删除和清空的数据可能无法通过 MCP 恢复。
- 已经发送的重放请求无法撤回。
- 已经被重写规则处理的请求不会因为规则被停用或删除而恢复。
- 关闭 MCP 服务会断开所有已连接的 AI 客户端。
- AI 客户端自身可能在调用 Tool 前要求确认。
- 不同 AI 客户端的 MCP 配置方式、Tool 确认方式和超时限制可能不同。
- AI 客户端能否完成多步骤任务，还会受到客户端模型能力、上下文长度和任务执行限制的影响。
RealSignal Pte. Ltd. © 2026 All rights reserved