BurpSuite接上AI:CustomAIAgent的59个MCP工具与安全边界

admin 2026-11-13 11:08:26 网络安全文章 来源:ZONE.CI 全球网 0 阅读模式

Burp Suite接上 AI:Custom AI Agent 的 59 个 MCP 工具与安全边界

网安之家-CyberHomestead

2026年11月11日 15:38
湖北

去阅读

Burp 接上 AI:Custom AI Agent 的 59 个 MCP 工具与安全边界

Custom AI Agent

连接 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 截图

Custom AI Agent 是一款 Burp Suite 扩展,将 AI 接入你的安全工作流。你可以使用本地模型或云端服务,通过 MCP 连接外部 AI 代理,让被动、主动扫描器查找漏洞,而自己专注于手工测试。

重要:如果你使用的是 1.0.0 或更早版本,请阅读安全公告,并升级到原文所述的最新版本 1.1.0。

开启审计日志时写入的审计文件,可能包含 MCP 令牌和完整提示;右键“发送到 AI”所携带的上下文,也可能绕过隐私模式。这两份安全公告均说明了需要轮换哪些凭据。上述公告均未获得 CVE 或 GHSA 编号。

v1.1.0 更新了什么?

一个仓库,两个构建版本,为重新提交 BApp Store 审核而准备。完整细节见 CHANGELOG.md。

两种构建

BApp Store 构建版通过 ./gradlew bappJar 构建,包含 8 个扩展原生 MCP 工具、Burp AI,以及六种 HTTP 后端。

GitHub 完整版通过 ./gradlew fullJar 构建,包含全部 59 个 MCP 工具、五种 CLI 后端、外部 MCP 客户端,以及需要主动启用的自动入队功能。

两个版本都可从 Releases 下载,每个文件均附带 .sha256。同一时间只加载一个版本。 两者的对比见《选择哪个构建版本?》(Which Build?)。

BApp Store 构建版的 AI 开关

BApp Store 构建版可以运行在 Burp Community 和 Burp Professional 上。只有为该扩展开启 Burp 的 Use AI 设置,它才会发送 AI 请求;关闭时,扩展仍会加载,但会拒绝所有 AI 请求。

被动扫描不向目标发送任何请求

两个构建版本都会在 AI Active Scanner 的队列对话框中,将可由主动扫描器测试的被动扫描发现列为建议目标。你需要手动将它们加入队列:确认之前,不会向目标发送任何内容。

卸载后完整停止

卸载扩展后,不会留下仍在运行的扩展线程、定时器或 MCP 监听器,也不会再向 AI 服务方发起新请求。

漏洞详情进行 HTML 编码

Payload、来自目标的值,以及 AI 生成的文本,都会在 Burp 的漏洞视图和报告中作为字面文本显示。

AI 扫描器默认关闭

两个构建版本每次加载时,AI 扫描器都处于 关闭 状态。手动开启后,该状态仅持续到 Burp 卸载扩展为止。

v1.0.1 更新了什么?

针对 1.0.0 的正确性与隐私热修复。完整细节见 CHANGELOG.md 和 SECURITY.md。

  • • 所有 HTTP 后端均能正确处理非 ASCII 提示(#84、#85、#86、#88)。请求体以 UTF-8 字节发送;此前,非 ASCII 字符会损坏,来自目标的文本还可能改变请求的 JSON 结构。
  • • 隐私修复。 右键上下文、扫描器设置、审计日志和聊天链接,现在都会遵守隐私模式,以及审计默认仅记录哈希的策略;聊天链接必须经过确认才会打开。
  • • 扫描器安全。 只有在 DANGEROUS 级别下,才会重放会改变状态的请求;Burp Scanner 的 AI 检查会遵守扫描任务的资源池限制和 AI 被动扫描开关。
  • • 可靠性。 NVIDIA NIM 和 Perplexity 恢复正常,后续聊天消息会保留上下文,脱敏处理也不会再因机器较慢或繁忙而丢失内容。
  • • 随包依赖。 Netty 4.1.138、Jackson 2.22.3。

v1.0.0 更新了什么?

首个稳定版本,也是安全正确性方面的一个里程碑。

2026 年 8 月 5 日,一次针对 0.9.2 的外部审查,通过运行已发布的代码,确认了两个可利用缺陷。这个版本修复了这两个问题,以及同一次审查揭示的更广泛的一类问题。完整细节见 CHANGELOG.md。

已修复并披露

SEC-04,严重:MCP 访问控制检查没有在已匹配的路由上执行。

启用外部访问后,监听器会接受未经认证的工具调用;在本地模式下,Origin、Host、User-Agent 检查,以及安全响应头,对已匹配的路由均不生效。

现在,访问控制判断会在路由处理之前执行。

需要采取的措施:轮换 MCP 令牌。

PRIV-05,高危:STRICT 和 BALANCED 模式下,会话 Cookie 未经脱敏便被发送给 AI 后端。

被动扫描器以裸 name=value 形式输出 Cookie,丢掉了脱敏规则依赖的前缀,导致只有名称恰好为 session 的 Cookie 才会被识别。

需要采取的措施:轮换受影响的 Cookie。

进一步加固

  • • 模型输出的工具调用需要你的批准(SEC-06)。 从模型输出中解析出的工具调用,不会在你作出决定前提交给 Burp。安全分级遵循默认拒绝原则:无法识别的工具名,每次调用都必须确认,绝不会静默执行。详见“隐私与安全说明”。
  • • 端口接管过程中不再泄漏 MCP 令牌(SEC-07)。 此前,本地进程可以抢占 MCP 端口,并回显身份标识头,从而获取具备完整 MCP 工具访问权限的令牌。现在,接管客户端改为提交基于 HMAC 的持有证明;在 TLS 下,还会将服务端证书固定校验为自身密钥库中的证书。
  • • SsrfGuard 能识别其他 IP 表示形式(SEC-07)。http://2852039166/ 是 169.254.169.254 的十进制表示,不能再仅靠改变写法绕过私有地址或链路本地地址警告;分类过程现在也完全不执行域名解析。
  • • 按允许列表规则为 Shell 参数添加引号(QUAL-06)。 修复了从设置导入到命令执行的一条路径:包含元字符但不含空格的值,例如 foo;id、$(cmd),此前可能触发该问题。
  • • EDT 线程约束与调度器稳健性。 工具执行、后端 HTTP 请求和 MCP stop() 已移出 Swing 事件派发线程;周期任务也增加了异常保护,避免因异常而停止运行。

已验证的变化: 测试套件从 660 个测试增至 1131 个,覆盖 158 个测试类;项目行覆盖率从 34% 提升到 58%;detekt 基线则从 1096 缩减到 1040,而不是继续膨胀。

核心亮点

  • • 12 种 AI 后端。 Burp AI(内置)、Anthropic、Ollama、LM Studio、NVIDIA NIM、Perplexity、通用 OpenAI 兼容后端、Gemini CLI、Claude CLI、Codex CLI、OpenCode CLI、Copilot CLI。BApp Store 构建版包含其中 7 种,即 Burp AI 加六种 HTTP 后端;五种 CLI 后端仅在完整版中提供。
  • • 59 个 MCP 工具。 让 Claude Desktop 或其他 MCP 客户端自主操作 Burp;商店构建版包含 8 个扩展原生 AI 工具,完整版包含全部 59 个。
  • • 限定范围的 MCP 访问。 可选地将每个 MCP 工具限制在测试范围内的主机上,使外部 AI 客户端无法通过 Burp 访问范围外目标。
  • • 62 类漏洞。 被动与主动 AI 扫描器覆盖注入、认证、密码学等类别。被动扫描器以 Burp PassiveScanCheck 的形式运行,需要 Burp Pro。
  • • 从 Releases 安装。 两种构建都从 Releases 下载,差异见《选择哪个构建版本?》。Custom AI Agent 尚未上架 BApp Store:商店构建版正在 extension-portal#231 中接受 PortSwigger 审核。
  • • 适配主题的界面。 内部设计系统统一设置面板样式,并随 Burp 的浅色、深色主题切换自动调整。
  • • Burp Scan Skill。 通过 MCP,把你偏好的 AI 编程助手——Claude Code、Gemini CLI、Codex 等——用作扫描器。
  • • 工具调用确认。 对 AI 发出的工具调用设有审批控制:只读且输出有界的工具静默执行,其余工具先在聊天中通过审批卡片请求确认;未知工具默认拒绝自动执行。
  • • 三种隐私模式。STRICT / BALANCED / OFF,在敏感数据离开 Burp 前进行脱敏。
  • • 自定义提示库。 按上下文类型保存自由编写的提示,支持 HTTP 请求或扫描器漏洞;可从右键菜单启动,也可通过 Custom… 临时输入。
  • • 审计日志。 可主动开启 JSONL 日志,每条记录附带 SHA-256。除非开启详细审计(Verbose audit),否则提示、上下文和响应只记录 SHA-256 与长度,凭据则始终不会写入。每次启动均标记 promptSource / contextKind,便于复现。

快速开始

1. 安装

从 Releases 下载最新 JAR。每个发布版本均包含:

  • • Custom-AI-Agent-full-<version>.jar:GitHub 完整版。
  • • Custom-AI-Agent-bapp-<version>.jar:BApp Store 构建版。

每个文件均附带 .sha256。选择说明见《选择哪个构建版本?》。也可以使用 Java 21 从源码构建:

git clone https://github.com/six2dez/burp-ai-agent.git
cd burp-ai-agent

# 完整版,面向 GitHub Releases,包含全部 59 个 MCP 工具
JAVA_HOME=/path/to/jdk-21 ./gradlew clean fullJar
# 输出:build/libs/Custom-AI-Agent-full-<version>.jar

# 商店构建版,用于提交 BApp Store,仅包含 8 个扩展原生 AI MCP 工具
JAVA_HOME=/path/to/jdk-21 ./gradlew clean bappJar
# 输出:build/libs/custom-ai-agent-bapp.jar

2. 加载到 Burp

    1. 打开 Burp Suite Community 或 Professional。
    1. 进入 Extensions > Installed > Add。
    1. 将扩展类型选择为 Java,再选择 .jar 文件。

扩展会以 Custom AI Agent 的名称注册到 Burp,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 Community 和 Professional 上;只有为扩展开启 Use AI,它才发送 AI 请求。关闭时,扩展照常加载,但拒绝所有 AI 请求。

PortSwigger 文档将 Use AI 描述为每个扩展独立的复选框,默认关闭,位置为:

Extensions > Installed > Custom AI Agent > Use AI

加载扩展

3. 代理配置档案

首次运行时,扩展会自动把随包附带的配置档案安装到 ~/.burp-ai-agent/AGENTS/。

向该目录添加其他 *.md 文件,即可添加自定义配置档案。

4. 配置后端

打开 AI Agent 标签页,进入 Settings,选择一个后端。

后端 类型 配置方式
Burp AI,内置 进程内 使用 Burp 内置 AI,需要为扩展开启 Use AI,见“运行要求”;无需其他配置
Ollama 本地 HTTP 安装 Ollama,运行 ollama serve,拉取模型,例如 ollama pull llama3.1
LM Studio 本地 HTTP 安装 LM Studio,加载模型,启动服务
NVIDIA NIM HTTP 使用默认端点 https://integrate.api.nvidia.com,设置 NVIDIA API 密钥,并选择模型,例如 moonshotai/kimi-k2.5
Perplexity HTTP 使用默认端点 https://api.perplexity.ai,设置 pplx-... API 密钥,并选择 sonar、sonar-pro 或 sonar-reasoning 等模型
通用 OpenAI 兼容后端 HTTP 为任意 OpenAI 兼容服务提供基础 URL 和模型名称
Gemini CLI 云端 CLI,仅完整版 安装 gemini,运行 gemini auth login
Claude CLI 云端 CLI,仅完整版 安装 claude,设置 ANTHROPIC_API_KEY 或运行 claude login
Codex CLI 云端 CLI,仅完整版 安装 codex,设置 OPENAI_API_KEY
OpenCode CLI 云端 CLI,仅完整版 安装 opencode,配置服务方凭据
Copilot CLI 云端 CLI,仅完整版 安装 copilot,使用 GitHub 账号登录
Anthropic 云端 API 在 Settings 中填写 Anthropic API 密钥;API 流量通过 Burp 代理,详见 docs/anthropic-backend.md

对于 NVIDIA NIM,后端预期使用与 NVIDIA 托管端点相同的 chat-completions 交互流程。原文给出的可用配置如下:

Backend: NVIDIA NIM
Base URL: https://integrate.api.nvidia.com
Model: moonshotai/kimi-k2.5
API Key: <your nvapi token>

除非网关有要求,否则让额外请求头保持为空。扩展会向 /v1/chat/completions 发送请求,并自动使用已配置的 Bearer 令牌。

5. 运行第一次分析

    1. 通过 Burp Proxy 浏览目标。
    1. 在 Proxy > HTTP History 中右键单击任意请求。
    1. 选择 Extensions > Custom AI Agent > Analyze this request。
    1. 一个包含 AI 分析结果的聊天会话随即打开。

右键菜单

6. 通过 MCP 连接 Claude Desktop,可选

在 Settings > MCP Server 中启用 MCP 服务,然后将以下内容加入 Claude Desktop 配置。

  • • macOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • • Windows:%APPDATA%\\Claude\\claude_desktop_config.json
{
  \"mcpServers\": {
    \"burp-ai-agent\": {
      \"command\": \"npx\",
      \"args\": [
        \"-y\",
        \"supergateway\",
        \"--sse\",
        \"http://127.0.0.1:9876/sse\"
      ]
    }
  }
}

需要 Node.js 18+。如果启用 External Access,MCP 客户端必须在每个请求中发送 Authorization: Bearer <token>。

仅完整版: 还可以在 Settings > MCP Server > External MCP Servers 中注册外部或自定义 MCP 服务,支持 SSE 或 stdio 传输。

外部服务的认证令牌会加密存储,但存在“隐私与安全说明”中所述的限制。配置细节和安全注意事项见 docs/external-mcp-servers.md。

Burp Scan Skill:终端 AI 扫描

burp-scan 技能让你可以在终端里,把 Claude Code、Gemini CLI、Codex 等 AI 编程助手用作 Burp 扫描器。

此时,不再由插件内置 AI 提供推理能力,而是由你的终端 AI 负责推理,Burp 通过 MCP 提供工具。

包含什么?

  • • 按扫描操作组织的 MCP 工具参考,完整版最多涵盖全部 59 个工具。
  • • 被动分析规程:分析流量,不发送请求。
  • • 主动测试 Payload 库:200 多个 Payload,覆盖 62 类漏洞,并包含检测模式。
  • • 端到端扫描流程:范围 → 被动分析 → 主动测试 → 带外验证(OOB)→ 报告。
  • • 漏洞创建规程,包含严重性与置信度映射。

为 Claude Code 安装

将技能复制到 Claude Code 技能目录:

# 全局安装,所有项目均可使用
cp -r skills/burp-scan ~/.claude/skills/burp-scan

# 或仅对当前项目安装
cp -r skills/burp-scan .claude/skills/burp-scan

随后在 Claude Code 中使用 /burp-scan,或在提及 Burp 扫描时让它自动触发。

为其他 AI 助手安装

该技能是一个独立的 Markdown 文件,路径为 skills/burp-scan/SKILL.md,可以配合任何支持系统提示或上下文文件的 AI 助手使用。

  • • Gemini CLI / Codex / OpenCode: 将其添加为上下文文件,或粘贴到系统提示中。
  • • 自定义 MCP 客户端: 在配置 MCP 连接的同时,将技能内容作为系统上下文提供。
  • • 任意 LLM: 该文件自包含,可将其与 MCP 工具定义一起作为上下文输入。

使用示例

你:连接 localhost:9876 上的 Burp MCP,扫描代理历史中的 IDOR 漏洞。

AI:[使用 proxy_http_history 获取流量]
    [识别带有数字 ID 的端点]
    [通过 http1_request 发送 ID+1、ID-1 Payload]
    [比较响应中不同用户的数据]
    [通过 issue_create 为已确认的 IDOR 创建漏洞记录]

技能与插件内置扫描器互为补充:插件执行自动化后台扫描,技能则支持在终端中开展由分析人员引导的交互式扫描。

文档

完整文档位于 burp-ai-agent.six2dez.com。

  • • 安装。
  • • 选择哪个构建版本?
  • • 快速开始。
  • • 界面导览。
  • • 代理配置档案。
  • • 被动扫描器。
  • • 主动扫描器。
  • • MCP 概览。
  • • 隐私模式。
  • • 设置参考。
  • • 安全公告。
  • • 故障排查。
  • • Burp Scan Skill。
  • • 操作员操作手册。
  • • MCP 加固。
  • • 界面安全指南。
  • • 后端故障排查。
  • • Anthropic 后端配置。
  • • 外部 MCP 服务。

隐私与安全说明

静态凭据加密:能保护什么,不能保护什么?

所有存储的 API 密钥和令牌,包括 Anthropic 密钥、MCP Bearer 令牌、TLS 密钥库密码等,都会通过 SecretCipher,使用每次安装随机生成的主密钥,以 AES-256-GCM 加密。

但这个主密钥本身也存储在 Burp Preferences 中:经过 Base64 编码,与其保护的密文放在一起,对应首选项为 secret.master.key.v1。

因此,任何能够读取 Burp Preferences 的人,也能读取主密钥并解密这些凭据。

这不能抵御本地攻击者,也不能抵御以你的用户身份运行的恶意进程。应将它视为防止他人随手查看首选项文件或导出项目时直接读到凭据的混淆措施。

如果凭据必须在这种威胁模型下仍受到保护,就应把它放在专门的秘密存储中,每个会话单独粘贴。

模型发出的工具调用需要审批

扩展从模型输出中解析出的工具调用,不会在你作出决定前对 Burp 执行。每个工具都有必需的安全级别:

    1. 自动运行:只读,且输出有界。
    1. 请求确认,可选择 Approve for session,即本会话批准。
    1. 每次调用都单独确认。

工具目录无法识别的工具名,统一按“每次确认”处理,绝不自动执行。带 ext: 命名空间的外部工具,也始终逐次确认。

审批以聊天记录内的卡片呈现,而不是弹窗。每次决定都会留下记录:一条审计事件,以及 Burp Output 标签页中的一行输出,因为审计日志默认关闭。

拒绝时,会向模型返回中性的“未获授权,请勿重试”(not authorised, do not retry),而不是错误。

这个安全级别独立于 Unsafe Mode 开关:Unsafe Mode 决定工具是否允许执行,安全级别决定模型能否不经询问就执行它。

设计依据见 DECISIONS.md 中的 ADR-15;操作手册见 docs/ui-safety-guide.md。

三种隐私模式

  • • STRICT: 使用真正的 HKDF,即 HMAC-SHA256 的提取与扩展过程,对主机标识进行匿名化。
  • • BALANCED: 对 Cookie、令牌和认证头进行脱敏。
  • • OFF: 原样发送流量。

外部 MCP 响应的信任边界

仅完整版:外部 MCP 服务输出在进入 AI 提示之前,会用信任边界标记包裹,以防止不可信服务响应中的提示注入。

设置迁移

设置在内部通过 settings.schema.version 进行结构版本管理,加载时采用增量迁移,以支持安全升级。

运行要求

  • • Burp Suite Community 或 Professional,2026.2 或更新版本。
  • • BApp Store 构建版的 AI 功能: 该版本可运行在 Community 和 Professional 上;只有为扩展开启 Use AI,才会发送 AI 请求。关闭时仍可加载,但拒绝所有 AI 请求。GitHub 完整版的 HTTP 与 CLI 后端不依赖 Burp 的 Use AI;Burp AI,以及 MCP 工具 ai_analyze、ai_passive_scan,仍然依赖这一开关。详见《选择哪个构建版本?》。
  • • Java 21。 现代 Burp 已捆绑运行所需的 Java;从源码构建时,需要单独安装。
  • • 至少配置一个 AI 后端,见前面的后端表格。

许可证

本项目采用 MIT 许可证。

免责声明

未经事先同意,使用 Custom AI Agent 攻击目标属于违法行为。遵守所有适用法律是使用者的责任。开发者不对工具被滥用或由此造成的损害承担责任。请负责任地使用。

参与贡献

欢迎提交 Issue 和 Pull Request。开发环境配置与贡献指南见 CONTRIBUTING.md,架构细节见开发者文档。


项目结构、输出结果与 info 索引

以下依据附件中的仓库页面整理。版本状态、统计值和相对时间均为原文快照,不代表实时查询结果;目录树只展开附件中可见的路径,构建输出单独列示。

项目目录树

six2dez/burp-ai-agent
├── .github/
├── .planning/
├── AGENTS/
├── burp/
│   └── api/montoya/persistence/
├── docs/
├── gradle/
│   └── wrapper/
├── screenshots/
├── skills/
│   └── burp-scan/
├── src/
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .tool-versions
├── AGENTS.md
├── BappManifest.bmf
├── CHANGELOG.md
├── CLAUDE.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── DECISIONS.md
├── LICENSE
├── README.md
├── SECURITY.md
├── SPEC.md
├── build.gradle.kts
├── detekt-baseline.xml
├── detekt.yml
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle.kts

文件提交信息

提交信息 / 附件快照
├── .github/、docs/、BappManifest.bmf、CHANGELOG.md、DECISIONS.md、README.md、
│   SECURITY.md、build.gradle.kts、detekt-baseline.xml
│   └── 发布 1.1.0(#105) · 3 周前
├── .planning/
│   └── 文档:在 STATE 中记录会话停止点 · 3 个月前
├── AGENTS/
│   └── 在未使用该选项时,移除对 includeUnprocessedResponse 的提及 · 8 个月前
├── burp/api/montoya/persistence/、skills/burp-scan/
│   └── v0.5.0 · 8 个月前
├── gradle/wrapper/、gradlew、gradlew.bat
│   └── v0.1.4 · 9 个月前
├── screenshots/
│   └── 新截图 · 10 个月前
├── src/
│   └── 修复 Windows CI:在读取源码的测试中规范化 CRLF(#106) · 3 周前
├── .editorconfig
│   └── 修复(sc3):门禁切换后的 detekt 与编译问题 · 5 个月前
├── .gitattributes、CLAUDE.md、CONTRIBUTING.md、SPEC.md、detekt.yml
│   └── codex/resume phase 29 PR(#103) · 上个月
├── .gitignore、.tool-versions、CODE_OF_CONDUCT.md
│   └── 发布 v0.6.0 · 7 个月前
├── AGENTS.md
│   └── 文档(19-05):为 v0.9.0 更新 README/DECISIONS/SPEC,并跟踪 SPEC.md/… · 5 个月前
├── LICENSE
│   └── 首次提交 · 10 个月前
├── gradle.properties
│   └── 从 gradle.properties 移除 Java home 路径 · 8 个月前
└── settings.gradle.kts
    └── 升级 org.gradle.toolchains.foojay-resolver-convention · 7 个月前

构建与输出结果树

Custom AI Agent / 构建与输出
├── GitHub 完整版
│   ├── 构建:JAVA_HOME=/path/to/jdk-21 ./gradlew clean fullJar
│   ├── 源码构建输出:build/libs/Custom-AI-Agent-full-<version>.jar
│   ├── 发布文件:Custom-AI-Agent-full-<version>.jar,附 .sha256
│   ├── MCP 工具:59 个
│   ├── 后端:Burp AI + 六种 HTTP 后端 + 五种 CLI 后端
│   └── 额外能力:外部 MCP 客户端、需主动启用的自动入队
├── BApp Store 构建版
│   ├── 构建:JAVA_HOME=/path/to/jdk-21 ./gradlew clean bappJar
│   ├── 源码构建输出:build/libs/custom-ai-agent-bapp.jar
│   ├── 发布文件:Custom-AI-Agent-bapp-<version>.jar,附 .sha256
│   ├── MCP 工具:8 个扩展原生 AI 工具
│   ├── 后端:Burp AI + 六种 HTTP 后端,共 7 种
│   └── AI 请求:必须为该扩展开启 Use AI
├── 运行中的结果
│   ├── 请求分析:聊天会话中的 AI 分析
│   ├── 漏洞:Burp 漏洞视图与报告,内容按 HTML 编码显示
│   ├── 审计:可选 JSONL,逐条 SHA-256,默认只记内容哈希与长度
│   └── 工具审批:聊天内审批卡片、审计事件与 Burp Output 记录
└── 共同限制
    ├── 一次只加载一种构建
    ├── 每次加载时 AI 扫描器默认关闭
    └── 被动扫描不向目标发请求,主动扫描建议目标需要手动确认入队

项目 info

Custom AI Agent / info
├── 所有者:six2dez
├── 仓库:burp-ai-agent
├── 当前扩展名称:Custom AI Agent
├── 原名称:Burp AI Agent
├── 可见性:公开
├── 项目说明
│   └── Burp Suite 扩展,提供内置 MCP 工具、AI 辅助分析、隐私控制、被动与主动扫描等功能
├── 仓库地址:https://github.com/six2dez/burp-ai-agent.git
├── 文档站点:burp-ai-agent.six2dez.com/
├── 配置目录:~/.burp-ai-agent/
├── 许可证:MIT
├── 最近提交
│   ├── 提交者:six2dez 与 claude
│   ├── 提交标识:b1738c0
│   ├── 提交说明:修复 Windows CI,在读取源码的测试中规范化 CRLF(#106)
│   └── 页面显示时间:3 周前
├── Pull requests:6
├── Stars:1.6k
├── Watchers:16
├── Forks:233
├── 发布版本:20
│   ├── 页面标记的最新版本:v1.1.0
│   ├── 页面显示时间:3 周前
│   └── 其他发布版本:19
├── BApp Store 状态:原文称尚未上架,正在 extension-portal#231 接受审核
├── 软件包:尚未发布
├── 贡献者:7
│   ├── @six2dez
│   ├── @claude
│   ├── @amrosia
│   ├── @dependabot[bot]
│   ├── @0-0eth0
│   ├── @Somchandra17
│   └── @Copilot
├── 赞助
│   ├── GitHub Sponsors:@six2dez
│   ├── buymeacoffee.com/six2dez
│   ├── https://www.paypal.com/paypalme/six2dez
│   └── 了解更多 GitHub Sponsors 信息
└── 语言:Kotlin 100%

文章与文档索引

Custom AI Agent / 内容索引
├── 版本与安全更新
│   ├── v1.1.0:双构建、Use AI 控制、被动扫描边界、卸载清理与 HTML 编码
│   ├── v1.0.1:UTF-8、隐私修复、扫描安全与后端可靠性
│   └── v1.0.0:SEC-04、PRIV-05 修复及安全加固
├── 快速开始
│   ├── 下载或构建 → 加载单一版本 → 代理配置档案
│   ├── 配置后端 → 请求分析
│   └── 可选 MCP:Claude Desktop / 外部 MCP 服务
├── Burp Scan Skill
│   ├── 文件:skills/burp-scan/SKILL.md
│   ├── MCP 工具参考、被动规程、主动 Payload、扫描流程与漏洞创建规程
│   └── Claude Code / Gemini CLI / Codex / OpenCode / 自定义 MCP 客户端
├── 隐私与安全
│   ├── 静态加密限制:主密钥与密文均位于 Burp Preferences
│   ├── 工具分级审批与 Unsafe Mode 的区别
│   ├── STRICT / BALANCED / OFF
│   ├── 外部 MCP 响应的信任边界
│   └── 设置结构版本与迁移
├── 参考文件
│   ├── CHANGELOG.md:版本变更
│   ├── SECURITY.md:安全公告
│   ├── DECISIONS.md ADR-15:审批设计依据
│   ├── docs/ui-safety-guide.md:界面安全操作手册
│   ├── docs/anthropic-backend.md:Anthropic 后端配置
│   ├── docs/external-mcp-servers.md:外部 MCP 配置与安全说明
│   └── CONTRIBUTING.md:开发配置与贡献指南
└── 运行与授权
    ├── Burp Community / Professional 2026.2+
    ├── Java 21、至少一个 AI 后端
    ├── Claude Desktop MCP 桥接需要 Node.js 18+
    └── MIT 许可证、事先同意与合法使用要求

仓库页面导航

Custom AI Agent / 页面导航
├── 仓库导航
│   ├── 代码(Code)
│   ├── 议题(Issues)
│   ├── 拉取请求(Pull requests):6
│   ├── 代理(Agents)
│   ├── 自动化工作流(Actions)
│   ├── 安全与质量(Security and quality)
│   └── 洞察(Insights)
├── 文件导航:README / 行为准则 / 贡献指南 / MIT 许可证 / 安全
└── 侧栏入口
    ├── 关于(About)
    ├── 主题(Topics)
    ├── 资源(Resources)
    │   └── Readme / MIT 许可证 / 行为准则 / 贡献指南 / 安全策略
    ├── 活动(Activity)
    ├── Stars / Watchers / Forks
    ├── 举报仓库(Report repository)
    ├── 发布版本(Releases)
    ├── 赞助项目(Sponsor this project)
    ├── 软件包(Packages)
    ├── 贡献者(Contributors)
    └── 语言(Languages)

评论:0   参与:  0