Hermes Agent 接入 Burp MCP:WSL 端口桥接、Origin 403 与异步 SSE 排障
tools/burp · verified
一句话结论
Hermes Agent 原生支持 MCP,可以不经 MCPorter 直接连接 Windows 上的 Burp AI Agent;在 WSL 环境下需要依次解决 netsh portproxy 顺序、Windows 防火墙、Origin 403、tools/call 异步 202+SSE 以及 Privacy 脱敏五个问题,才能真正用 Agent 发请求和读历史。
原理
- 架构:Burp AI Agent 插件内置 MCP Server(SSE + 可选 stdio bridge),默认监听
127.0.0.1:9876;Hermes 的 native-mcp 客户端通过http://<Windows 网关 IP>:9876/sse连接,链路为Hermes → Burp AI Agent → Burp Suite,比OpenClaw → MCPorter → Burp AI Agent少一层中间件。 - WSL 与 Windows 的环回地址隔离:WSL 的
127.0.0.1与 Windows 的127.0.0.1不是同一个网络命名空间。Burp 只绑127.0.0.1时 WSL 连不上;Burp AI Agent v0.9.0 又不支持直接绑0.0.0.0(改了会 Error),所以要用netsh interface portproxy把 Windows 的0.0.0.0:9876转发到127.0.0.1:9876。 - portproxy 顺序坑:如果先加 portproxy 再启动 MCP,portproxy 已占用 9876,Burp MCP 会报 “Port in use”。正确顺序是:删旧转发 → 在 Burp 里启用 MCP 并等 Running → 再加转发。
netstat -ano | findstr 9876看到127.0.0.1:9876对应 PID 是javaw.exe(不是svchost.exe)才说明 Burp 在监听。 - Windows 防火墙:Defender 默认拦截从 vEthernet(WSL)网卡进入的连接;测试环境可临时关闭,生产环境应加放行规则只允许 WSL 网段访问 9876。
- Origin 403:Hermes 的 httpx 会自动带
Origin头,Burp AI Agent v0.9.0 有 CORS 检查;curl 手动测是 200,Hermes 却 403。在config.yaml的 MCP server 配置里加headers: {Origin: ""},让客户端不发送 Origin 头即可。 - 异步 tools/call:Burp MCP 的所有
tools/call都是异步的——POST 返回202 Accepted,实际结果通过已建立的 SSE 连接推回。只发 POST 就断开会丢结果;客户端必须保持 SSE 连接并读取异步消息。 - Privacy 脱敏:Privacy mode 为 BALANCED 时,历史里的
Cookie/Authorization会被替换为[REDACTED]/[STRIPPED];要拿完整 Cookie/JWT 需改为 OFF(同时意味着敏感数据进入 Agent 上下文,需权衡)。 - 环境要求:Burp Suite 2026.3.x 需要 JDK 21+(class file version 65.0),JDK 17 会报
UnsupportedClassVersionError;Hermes v0.13+、Python 3.11+;社区版 AI 功能不可用(ai_analyze/ai_passive_scan报错),但 MCP 的 HTTP/历史/Repeater/Intruder/Collaborator 工具仍可用。
触发条件
- 宿主机 Windows,Agent 跑在 WSL/macOS/Linux;Burp AI Agent v0.9.0+ 已加载并启用 MCP Server。
- 需要让 Agent 调用 Burp 的
http1_request、proxy_http_history_regex、Repeater/Intruder/Collaborator 等工具。 - WSL 能访问 Windows 的 vEthernet 网关 IP(如
172.18.x.1),且 9876 未被其他进程占用。 - 允许配置
netsh portproxy(管理员权限)、防火墙规则与 Hermesconfig.yaml。 - 已明确授权目标与扫描范围;Agent 只用于授权测试。
利用步骤
- 装 Burp 与插件:用 JDK 21 启动 Burp;
Extensions → Add → Java选择 Burp AI Agent v0.9.0 jar;打开Custom AI Agent标签页。 - 配 MCP Server:Host
127.0.0.1、Port9876;需要写操作时勾Unsafe mode;Settings → Privacy & Logging按需把 Privacy mode 从 BALANCED 改为 OFF。 - 装 Hermes:执行安装脚本;把
~/.hermes/hermes-agent加入~/.profile的 PATH;补齐fire prompt_toolkit rich openai requests pyyaml。 - 建端口转发:先删除旧 portproxy,启动 Burp MCP 等 Running,再执行
netsh interface portproxy add v4tov4 listenport=9876 listenaddress=0.0.0.0 connectport=9876 connectaddress=127.0.0.1;用netstat -ano | findstr 9876验证 PID 为javaw.exe。 - 放行防火墙:测试环境可临时关闭;生产环境加
dir=in action=allow protocol=TCP localport=9876规则,并限制来源网段。 - 配 Hermes:
mcp_servers.burpsuite.url = http://<网关IP>:9876/sse,timeout/connect_timeout适当放大,headers: {Origin: ""}。 - 调工具:用封装脚本保持 SSE 连接:先 GET
/sse拿 sessionId,再 POSTtools/call,从 SSE 读取异步结果;例如status、http1_request、proxy_http_history_regex。 - 验证:用
status确认连接;用http1_request对授权目标发 GET;用proxy_http_history_regex查历史;确认 Cookie/JWT 是否被脱敏。
PoC
Hermes config.yaml:
mcp_servers:
burpsuite:
url: "http://172.18.64.1:9876/sse"
timeout: 300
connect_timeout: 60
headers:
Origin: ""
Windows 端口转发(顺序不能错):
:: 1) 删旧转发
netsh interface portproxy delete v4tov4 listenport=9876 listenaddress=0.0.0.0
:: 2) 在 Burp AI Agent 里启用 MCP,等状态变 Running
:: 3) 再加转发
netsh interface portproxy add v4tov4 listenport=9876 listenaddress=0.0.0.0 connectport=9876 connectaddress=127.0.0.1
:: 4) 验证:PID 应为 javaw.exe
netstat -ano | findstr 9876
异步 SSE 调用封装(伪代码):
# 1) 开 SSE 连接拿 sessionId
sse = connect_sse("http://172.18.64.1:9876/sse")
session_id = get_session_id(sse)
# 2) 发 POST 请求调工具(服务端返回 202)
post_message(session_id, "tools/call", {"name": "status", "arguments": {}})
# 3) 从同一条 SSE 连接读取异步结果
result = read_sse_result(sse)
命令行示例:
python3 burp_mcp.py tools/call status '{}'
python3 burp_mcp.py tools/call http1_request '{"content":"GET / HTTP/1.1\r\nHost: example.com\r\nConnection: close\r\n\r\n","targetHostname":"example.com","targetPort":443,"usesHttps":true}'
python3 burp_mcp.py tools/call proxy_http_history_regex '{"regex":"target"}'
变体与关联
- 中间件变体:OpenClaw + MCPorter(多一层 npm 翻译层)、其他原生 MCP 客户端(Claude Desktop、Cursor)直连 Burp AI Agent。
- 传输变体:SSE、stdio bridge、HTTP streamable;不同客户端对 Origin/异步结果的处理不同。
- 环境变体:WSL2 镜像网络模式下环回地址行为不同;Docker 容器内的 Agent 需要 host 网络或额外端口映射。
- 关联卡片:[[ai-security-mcp-security-burp-mcp-server-exposure-unsafe-portproxy]](同一套配置的暴露面风险)、[[ai-security-agent-security-ai-pentest-evidence-driven-pipeline]](Agent 验证流水线)、[[ai-security-mcp-stdio-endpoint-command-injection]](MCP stdio 风险)。
- 边界:Burp AI Agent 版本升级可能改变端口/Origin/异步行为;社区版 AI 功能不可用;Cloudflare/WAF 可能拦截 Burp 直发请求,需要浏览器代理配合;未授权目标不适用。
检测与防御
- 最小暴露:Burp MCP 只绑
127.0.0.1;不要长期保留0.0.0.0portproxy;防火墙规则只允许 WSL/本机网段访问 9876。 - 权限最小化:只在需要写操作时开启 Unsafe mode;用完关闭;把 MCP 工具限制在授权目标(in-scope hosts)。
- 隐私权衡:Privacy mode 默认 BALANCED;只有确需完整 Cookie/JWT 时才临时改 OFF,并限制 Agent 日志/上下文留存。
- 审计:记录 MCP 工具调用、目标域名、请求数量;监控 9876 的连接来源;定期检查 portproxy 与防火墙规则。
- 合规:只对授权目标测试;限速;避免用 Agent 自动构造破坏性请求;报告脱敏。