Burp Suite 与现代 AI 之间的桥梁。
关于名称的说明: 本扩展以 Custom AI Agent 发布(原名 Burp AI Agent)。更名是为了符合 PortSwigger BApp Store 的命名要求,并避免与 Burp Suite 内置的 Burp AI 提供程序混淆。GitHub 仓库(
github.com/six2dez/burp-ai-agent)、文档站点(burp-ai-agent.six2dez.com)以及配置目录(~/.burp-ai-agent/)为保持连续性仍保留burp-ai-agent标识符。

Custom AI Agent 是一款 Burp Suite 扩展,可将 AI 集成到你的安全工作流中。可使用本地模型或云服务提供商,通过 MCP 连接外部 AI 代理,并让被动/主动扫描器发现漏洞,而你则专注于手动测试。
[!IMPORTANT] 如果你正在运行 1.0.0 或更早版本,请阅读安全公告并升级到最新版本 1.1.0。 在开启审计日志记录时写入的审计文件可能包含 MCP 令牌和完整提示词,并且右键 “发送到 AI”上下文可能绕过隐私模式;两项公告均说明了需要轮换哪些凭据。 其中任何一项均未分配 CVE 或 GHSA 标识符。
同一仓库构建出两个版本,专为 BApp Store 重新提交而构建。完整详情见 CHANGELOG.md。
./gradlew bappJar)包含 8 个扩展原生 MCP 工具、
Burp AI 和六个 HTTP 后端。GitHub 完整构建(./gradlew fullJar)包含全部 59 个 MCP
工具、五个 CLI 后端、外部 MCP 客户端和可选的自动排队功能。两者均发布在
Releases 上,各带一个 .sha256。一次仅加载
一个;选择哪个构建?
对它们进行了比较。针对 1.0.0 的正确性与隐私热修复。完整详情见 CHANGELOG.md 和 SECURITY.md。
首个稳定版本,也是安全正确性的里程碑。2026-08-05 对 0.9.2 的外部审查通过实际运行已发布的代码确认了两个可利用缺陷;本次发布修复了这两个缺陷,以及同一审查暴露出的更广泛的一类问题。完整细节见 CHANGELOG.md。
已修复并披露:
name=value,丢弃了作为脱敏依据的前缀,且只有字面名为 session 的 Cookie 会被捕获。→ 轮换受影响的 Cookie已加固:
SsrfGuard 可识别替代 IP 表示法(SEC-07)— http://2852039166/(169.254.169.254 的十进制形式)不再仅凭表示法绕过私有/链路本地警告,且分类过程现在完全不进行名称解析。foo;id、$(cmd))。stop() 已移出 Swing 事件调度线程;周期性任务增加了防护,避免因异常而终止。已验证: 测试套件从 660 个增长到 158 个类中的 1131 个测试,项目行覆盖率从 34% 提升至 58%,detekt 基线从 1096 缩减至 1040,而非增长。
PassiveScanCheck 运行(Burp Pro)。Custom… 输入临时提示词。promptSource / contextKind 以便复现。从 Releases 下载最新的 JAR:每个版本都包含 Custom-AI-Agent-full-<version>.jar(GitHub 完整构建)和 Custom-AI-Agent-bapp-<version>.jar(BApp Store 构建),各自附带一个 .sha256。Which Build? 说明了该选哪一个。或者从源码构建(Java 21):
git clone https://github.com/six2dez/burp-ai-agent.git
cd burp-ai-agent
# Full build (GitHub releases) — all 59 MCP tools
JAVA_HOME=/path/to/jdk-21 ./gradlew clean fullJar
# Output: build/libs/Custom-AI-Agent-full-<version>.jar
# Store build (BApp Store submission) — 8 extension-native AI MCP tools only
JAVA_HOME=/path/to/jdk-21 ./gradlew clean bappJar
# Output: build/libs/custom-ai-agent-bapp.jar
.jar 文件。该扩展在 Burp 中注册为 Custom AI Agent(即 Extensions 列表和 Suite 标签页中显示的名称),以区别于 Burp 内置的 Burp AI 提供程序。
只加载一个构建版本。 完整构建和 BApp Store 构建都会注册为 Custom AI Agent,因此它们在 Burp 的 Extensions 列表中看起来完全相同。同时加载两者会导致出现两个 Custom AI Agent 标签页、两个 MCP 服务器争用同一端口,以及两份副本写入共享的 ~/.burp-ai-agent 目录。在加载另一个之前,请先卸载其中一个。
Burp 版本与“Use AI”。 BApp Store 构建可在 Burp 社区版和 Burp 专业版上运行;它仅在 Burp 为该扩展启用“Use AI”设置时发送 AI 请求,关闭该设置时它会加载但拒绝所有 AI 请求。PortSwigger 将“Use AI”记录为每个扩展的复选框,默认关闭:Extensions > Installed > Custom AI Agent > Use AI。

该扩展在首次运行时会将捆绑的配置文件自动安装到 ~/.burp-ai-agent/AGENTS/。
将额外的 *.md 文件放入该目录即可添加自定义配置文件。
打开 AI Agent 标签页并转到 Settings。选择一个后端: