★ FEATURED ARTICLE 领取码: ZNVJCNDBWELNDX42QNNBJ25L3UAI生成标记本文由人工智能辅助生成内容仅供参考请以官方文档和实际环境为准。写在前面日常调试接口时我们习惯把报错的请求头、响应体一段段复制进 AI 对话框让它分析。但 AI 只能看到你贴过去的文字够不着你电脑上正在运行的抓包工具。MCPModel Context Protocol的出现改变了这一点——它让 AI 能够直接调用外部工具自己动手抓包、查流量、解码、重放。TraceEagle 是一款国产的轻量级抓包工具原生内置了 MCP 服务接入方式简单到一条命令即可完成。本文将基于DSH Desktop 0.2.0-rc.2、dsh-mcp-servers-panel v0.1.4以及Trace Eagle 1.1.14把完整的接入流程拆开来讲清楚。一、环境准备1.1 版本信息速览组件版本说明DSH Desktopv0.2.0-rc.2宿主环境profile 为desktopdsh-mcp-servers-panelv0.1.4MCP 服务器管理面板插件Trace Eaglev1.1.14抓包工具原生内置 MCP 服务1.2 安装并启动 Trace Eagle从 Trace Eagle 官网页面下载对应平台的桌面应用macOS / Windows / Linux安装后直接打开。需要以管理员权限运行因为底层抓包需要驱动级别的访问权限。注意stdio 模式下DSH Desktop 会通过命令行拉起Trace Eagle mcp子进程因此 Trace Eagle 桌面应用需要处于已启动状态。1.3 确认 DSH Desktop 环境确保 DSH Desktop 0.2.0-rc.2 已正常安装并能启动。1.4 安装 dsh-mcp-servers-panel 插件虽然 DSH 原生支持手动编辑 YAML 配置但dsh-mcp-servers-panel提供了图形化管理界面操作更直观。该插件在 DSH 设置中新增原生的「MCP 服务器」管理选项卡方便用户直观地新增、查看、修改、删除和启停 MCP 服务器并自动将发现的 MCP 工具注册为 DSH 原生工具供模型直接调用。安装命令dsh plugin--profiledesktopadddsh-mcp-servers-panel重要提示DSH 在进程启动时组合插件。如果你是在 DSH 已经运行的情况下安装的插件需要完全退出并重新打开 DSH Desktop不是刷新页面。重新启动后进入设置即可在左侧菜单中看到「MCP 服务器」选项卡。二、配置 Trace Eagle MCPstdio 模式2.1 为什么优先选择 stdioTrace Eagle 提供 stdio 和 HTTP 两种接入方式。stdio 模式适合 Trace Eagle 和 DSH Desktop 在同一台电脑上运行的场景由 DSH 主动拉起本地命令Trace Eagle mcp通过标准输入输出通信。它的优点是配置简单、延迟低且不需要手动确认端口号。只要能跑通 stdio就优先用 stdio。2.2 通过 dsh-mcp-servers-panel 图形化配置在「MCP 服务器」选项卡中点击「新增 MCP」选择表单模式按以下字段填写字段填写值说明服务名称traceeagle命名空间最终工具名会以mcp__traceeagle__开头传输协议stdio本地命令通信可执行命令TraceEagle要执行的命令注意 Trace Eagle 中间有空格参数列表mcp传递给命令的参数表单各字段的填写要点服务名称需满足^[A-Za-z0-9_-]{1,64}$规则仅允许字母、数字、下划线和连字符。可执行命令如果TraceEagle命令不在系统的PATH环境变量中需要填写完整的可执行文件路径。参数列表填写mcp与命令组合后等价于在终端中执行Trace Eagle mcp这正是 Trace Eagle 官方提供的 stdio 启动命令。点击保存。dsh-mcp-servers-panel 会自动将配置写入~/.dsh/mcp.json用户级作用域并自动维护 MCP 进程生命周期完成 MCP 协议握手initialize→notifications/initialized→tools/list将发现的工具以mcp__traceeagle__toolName注册至对话工具列表。2.3 手动 YAML 配置备选方案如果你偏好直接编辑配置文件可以打开 profile 的配置文件~/.dsh/profiles/desktop/cordis.patch.yml添加以下内容-id:mcp-traceeaglename:deepseek-ai/dsh-mcp-clientconfig:serverName:traceeagletransport:stdiocommand:TraceEagleargs:[mcp]几个关键点说明name固定为deepseek-ai/dsh-mcp-client这是 DSH Desktop 0.2.0-rc.2 自带的官方 MCP 客户端桥接插件。serverName是命名空间最终工具名会以mcp__traceeagle__工具名的形式注册给模型。commandargs组合成完整的启动命令Trace Eagle mcp。保存文件后DSH 的HMR热模块替换机制会自动重载配置无需重启 DSH 进程。三、验证配置是否生效配置保存后在 DSH Desktop 对话中直接说列出抓包工具能做什么如果 AI 能报出 Trace Eagle 的工具清单说明 MCP 服务连接成功。Trace Eagle 1.1.14 暴露了40 个工具按用途分为四组分组代表工具用途开抓start_nic_capture、start_app_capture、start_mobile_capture、start_remote_capture六种抓法直接启动代理与会话proxy_start、set_rules、set_intercept、add_key_source起代理、改规则、设断点检查与构造list_flows、get_flow、decode_bytes、send_request、replay_flow、generate_code、openapi_from_flows查流量、解码、重放、生成代码网络工具箱dns_lookup、tls_audit、ip_intel、net_diagnoseDNS、证书体检、连通性诊断在 dsh-mcp-servers-panel 的面板中每个服务器条目支持点击展开查看已发现的工具列表与描述如「42 个工具可用」运行状态指示灯会显示绿色在线、灰色禁用或红色连接中/错误。如果 AI 报不出工具清单请依次检查Trace Eagle 桌面应用是否已启动命令路径是否正确如果不在PATH中需填写完整路径配置是否被正确加载可查看 dsh-mcp-servers-panel 面板中的服务器状态四、实际使用演示配置完成后MCP 工具对 AI 完全透明就像内置工具一样。你可以直接说这个下单接口失败了帮我看看原因AI 会自己调用list_flows找到相关请求再用get_flow拉出完整的请求头和响应结合状态码判断是签名参数错了还是缺少 header。对接没有文档的接口时还可以让 AI 调openapi_from_flows把一批流量直接转成 OpenAPI 描述省去手工整理接口文档的麻烦。五、HTTP 模式配置补充如果你的 DSH Desktop 和 Trace Eagle 不在同一台机器上或者场景要求通过网络地址接入可以使用 HTTPstreamable-http模式。5.1 前提条件在 Trace Eagle 应用中找到 MCP HTTP 服务的开关并手动启动同时确认服务实际监听的端口号。与 stdio 模式不同HTTP 模式要求Trace Eagle 的 MCP 服务先启动并保持运行DSH 只负责连接不负责拉起进程。5.2 通过 dsh-mcp-servers-panel 配置在「新增 MCP」中选择表单模式传输协议选streamable-http填写字段填写值服务名称traceeagle-http传输协议streamable-http端点 URLhttp://IP:端口/api/mcp请求头如需要填写Authorization: Bearer token手动 YAML 配置等价于-id:mcp-traceeagle-httpname:deepseek-ai/dsh-mcp-clientconfig:serverName:traceeagle-httptransport:streamable-httpurl:http://IP:端口/api/mcpheaders:Authorization:Bearer ${MCP_TOKEN}安全建议凭据尽量通过${VAR}环境变量引用不要明文写入配置文件。DSH Desktop 0.2.0-rc.2 的官方 stdio 会丢掉父进程里名字像凭据的环境变量和DSH_*但写进env并经${VAR}展开的值仍然会传给子进程。六、常见问题Q工具没出现怎么排查依次检查Trace Eagle 桌面应用是否已启动 → 配置文件是否被正确加载可查看 dsh-mcp-servers-panel 面板中的服务器状态指示灯→ 命令路径是否正确。QHTTP 模式连不上怎么办检查 Trace Eagle 的 MCP HTTP 服务是否已开启 → URL 中的端口和路径是否正确 → 防火墙是否放行 → Authorization 头是否正确。Q修改配置后需要重启 DSH 吗保存后 dsh-mcp-servers-panel 会自动加载新配置无需重启。但如果修改了serverName工具名前缀会变化旧的工具名将失效。Qdsh-mcp-servers-panel 面板在哪里安装插件并完全退出后重新打开 DSH Desktop进入设置左侧菜单即可看到「MCP 服务器」选项卡。Q凭据怎么写才安全一律通过${环境变量名}的方式引用不要将 Token、密钥等明文写入mcp.json或cordis.patch.yml。七、总结整个配置流程可以概括为三步启动 Trace Eagle确保桌面应用正常运行安装 dsh-mcp-servers-panel v0.1.4在设置页的「MCP 服务器」面板中添加 stdio 服务填写serverName: traceeagle、transport: stdio、command: Trace Eagle、args: [mcp]验证连接在对话中让 AI 列出工具清单确认mcp__traceeagle__*系列工具已注册。配置完成后AI 就能直接调用 Trace Eagle 1.1.14 的抓包能力你不再需要人肉复制粘贴请求响应整个调试流程会顺畅很多。
阅读完成 · 觉得有帮助？
