burp-ai-agent

环境要求

• 已安装 Burp Suite（扩展宿主）
• 若从源码构建需 Java 21
• 一个 AI 提供商凭据（OpenAI/Anthropic 等云服务）或本地模型
• 可选：支持 MCP 的 AI 客户端（如 Claude Code、Gemini CLI、Codex）

安装与启动步骤

1. 1下载扩展 JAR

   到 GitHub Releases 页面下载最新版 JAR，务必选 1.0.0 及以上，0.9.x 存在已确认安全缺陷。

2. 2获取源码构建

   不想用预编译包时可克隆仓库自行构建，README 明确要求 Java 21 环境。

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

   复制

3. 3加载到 Burp

   在 Burp Suite 的 Extensions 中加载上一步得到的 JAR，扩展会以 Custom AI Agent 名称出现。

4. 4配置 AI 提供商

   在扩展设置里选择本地模型或云提供商并填入凭据；配置与密钥保存在 ~/.burp-ai-agent/ 目录。

5. 5首次分析请求

   通过 Burp Proxy 浏览目标，在 Proxy > HTTP History 右键请求，选择扩展菜单的 Analyze this request。

6. 6连接 MCP 代理

   如需外部 AI 代理接入，可用 MCP 连接本地服务，示例中地址为 localhost:9876。

7. 7安装扫描技能

   把 skills/burp-scan/SKILL.md 复制进 Claude Code 的技能目录，或作为上下文喂给其他 AI 助手。

关键配置

如何确认成功

在 Burp 的 Proxy > HTTP History 右键请求，选择 Extensions > Custom AI Agent > Analyze this request，能打开带 AI 分析的会话即成功。

常见问题

注意事项

• 务必使用 1.0.0 及以上版本，0.9.x 存在已确认的安全缺陷，且没有 CVE/GHSA 编号可查。
• README 节选中部分安装命令被截断（如构建命令、Claude Code 技能复制命令），执行前请对照官方文档补全。
• 仓库地址、文档站和配置目录仍使用 burp-ai-agent 标识，扩展显示名却是 Custom AI Agent，不要以为是两个项目。