burp-ai-agent v0.9.1
Burp Suite 拡張機能で、組み込みの MCP ツール、AI 支援分析、プライバシー制御、パッシブスキャンおよびアクティブスキャンなどを追加します。
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 は、Burp Suite に AI を統合する拡張機能です。ローカルモデルやクラウドプロバイダーを利用し、MCP 経由で外部 AI エージェントに接続し、パッシブ / アクティブスキャナーで脆弱性を発見しながら、手動テストに集中できます。
v0.9.0 の新機能
- ネイティブ Anthropic バックエンド (CAP-01) — Burp の HTTP トランスポートを介した直接的な Anthropic Messages API; すべてのトラフィックが Proxy 履歴に表示されます。
- 保存時の AES-256-GCM 暗号化 (SEC-01) — すべての保存済み API キーとトークンは、
javax.cryptoを使用したインストール単位の鍵で暗号化されます。設定に平文は保存されません。 - 本格的な HKDF ホスト匿名化 (PRIV-01) — STRICT モードでは、ホストの匿名化に (ソルト付き SHA-256 ではなく) 本物の HMAC-SHA256 extract/expand を使用します。
- リクエスト/レスポンス本文の編集 + カスタムパターン (PRIV-02) — 編集パイプラインが本文フィールドとユーザー設定可能な正規表現パターンを対象とし、ReDoS に対して検証済みです。
- 送信前シークレットトリップワイヤー (PRIV-03) — 高エントロピー値が Burp から送信される前に警告します。許可リストのアクションは監査ログに記録されます。
- 外部 MCP サーバー (CAP-02) — 外部/カスタム MCP サーバー (SSE または stdio) に接続し、AI エージェントが Burp の組み込みツールとともにそれらのツールを呼び出せるようにします。
- セッションごとのトークンバジェットガードレール (CAP-04) —
BudgetGuardがパッシブスキャナーの消費を WARN/CAP/OFF 状態で制限します。ハードキャップに達するとパッシブスキャナーは自動的に一時停止します。
ハイライト
- 11 の AI バックエンド — Burp AI (内蔵), Ollama, LM Studio, NVIDIA NIM, Perplexity, 汎用 OpenAI 互換, Gemini CLI, Claude CLI, Codex CLI, OpenCode CLI, Copilot CLI.
- 59 の MCP ツール — Claude Desktop (または任意の MCP クライアント) に Burp を自律的に操作させます (BApp Store ビルドでは 8 つの拡張ネイティブ AI ツール、フルビルドでは 59 ツールすべて)。
- スコープ付き MCP アクセス — すべての MCP ツールをインメモリのスコープ対象ホストに制限可能。外部 AI クライアントが Burp 経由でスコープ外のターゲットにアクセスするのを防ぎます。
- 62 の脆弱性クラス — パッシブおよびアクティブ AI スキャナーが、インジェクション、認証、暗号化などをカバー。パッシブスキャナーは Burp の
PassiveScanCheck(Burp Pro) として動作します。 - BApp Store で利用可能 — Burp の BApp Store から直接 Custom AI Agent をインストールするか、Releases からフルビルドを入手してください。
- テーマ対応 UI — 内部デザインシステムが設定パネルをスタイル付けし、Burp のライト/ダーク切り替えに合わせて自動的に再テーマ化します。
- Burp Scan Skill — お好みの AI コーディングアシスタント (Claude Code, Gemini CLI, Codex など) を MCP 経由でスキャナーとして使用できます。
- 3 つのプライバシーモード — STRICT / BALANCED / OFF。機密データが Burp から送信される前に編集します。
- カスタムプロンプトライブラリ — コンテキスト (HTTP リクエストまたはスキャナー Issue) ごとに自由形式のプロンプトを保存し、右クリックメニューから起動するか、
Custom…からアドホックに入力します。 - 監査ログ — SHA-256 整合性ハッシュ付きの JSONL 形式でコンプライアンス対応。すべての起動は、再現性のために
promptSource/contextKindでスタンプされます。
クイックスタート
1. インストール
Custom AI Agent を Burp の BApp Store からインストールするか、Releases から最新の JAR をダウンロードするか、ソースからビルドします (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 shadowJar
# 出力: build/libs/Custom-AI-Agent-full-<version>.jar
# Store ビルド (BApp Store) — 拡張ネイティブ AI MCP ツールのみ 8 個
JAVA_HOME=/path/to/jdk-21 ./gradlew clean shadowJar -PstoreBuild=true
# 出力: build/libs/Custom-AI-Agent-<version>.jar
2. Burp に読み込む
- Burp Suite (Community または Professional) を開きます。
- Extensions > Installed > Add に移動します。
- 拡張機能のタイプとして Java を選択し、
.jarファイルを選択します。
この拡張機能は、Burp 標準搭載の Burp AI プロバイダーと区別するため、(Extensions リストおよび Suite タブの名前として) Custom AI Agent として Burp に登録されます。
3. エージェントプロファイル
初回起動時に、バンドルされたプロファイルが ~/.burp-ai-agent/AGENTS/ に自動インストールされます。
カスタムプロファイルを追加するには、そのディレクトリに追加の *.md ファイルを配置します。
4. バックエンドの設定
AI Agent タブを開き、Settings に移動します。バックエンドを選択します:
| バックエンド | タイプ | セットアップ |
|---|---|---|
| Burp AI (内蔵) | インプロセス | Burp Suite Pro の内蔵 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 ホストエンドポイントと同じチャット補完フローを想定します。動作する設定例は次のとおりです:
Backend: NVIDIA NIM
Base URL: https://integrate.api.nvidia.com
Model: moonshotai/kimi-k2.5
API Key: <your nvapi token>
ゲートウェイが必要としない限り、追加ヘッダーは空のままにしておきます。拡張機能は /v1/chat/completions にリクエストを送信し、設定されたベアラートークンを自動的に使用します。
5. 最初の分析を実行する
- Burp Proxy を介してターゲットをブラウズします。
- Proxy > HTTP History 内の任意のリクエストを右クリックします。
- Extensions > Custom AI Agent > Analyze this request を選択します。
- 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 > External Servers で、外部またはカスタムの MCP サーバー (SSE または stdio トランスポート) を登録することもできます。外部サーバーの認証トークンは、保存時に暗号化されます。セットアップの詳細とセキュリティ上の注意については、docs/external-mcp-servers.md を参照してください。
Burp Scan Skill (ターミナル AI スキャン)
burp-scan スキルを使用すると、任意の AI コーディングアシスタント (Claude Code, Gemini CLI, Codex 等) をターミナルから Burp スキャナーとして利用できます。プラグインの内蔵 AI の代わりに、ターミナルの AI が推論エンジンとなり、Burp は MCP 経由でツールを提供します。
内容
- MCP ツールリファレンス (フルビルドでは最大 59 ツール) をスキャンアクションごとに整理
- パッシブ分析プロトコル (リクエストを送信せずにトラフィック分析)
- アクティブテストペイロードライブラリ (62 の脆弱性クラス向け 200 以上のペイロード、検出パターン付き)
- エンドツーエンドのスキャンワークフロー (スコープ → パッシブ → アクティブ → OOB → レポート)
- 重要度/確信度マッピング付き Issue 作成プロトコル
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 ツール定義とともにコンテキストとして提供
使用例
You: Burp MCP に localhost:9876 で接続し、プロキシ履歴を IDOR 脆弱性についてスキャンしてください
AI: [proxy_http_history を使用してトラフィックを取得]
[数値 ID を持つエンドポイントを特定]
[ID+1、ID-1 ペイロードで http1_request を送信]
[異なるユーザーデータに対するレスポンスを比較]
[確認された IDOR に対して issue_create を作成]
スキルとプラグインの内蔵スキャナーは補完的です。プラグインは自動的なバックグラウンドスキャンを実行し、スキルはターミナルからの対話的でアナリスト主導のスキャンを可能にします。
ドキュメント
完全なドキュメントは burp-ai-agent.six2dez.com で公開されています。
- インストール
- クイックスタート
- UI ツアー
- エージェントプロファイル
- パッシブスキャナー
- アクティブスキャナー
- MCP 概要
- プライバシーモード
- 設定リファレンス
- トラブルシューティング
- Burp Scan Skill
オペレータープレイブック
プライバシーとセキュリティに関する注意
- 保存されるすべての API キーとトークン (Anthropic、MCP ベアラートークン、TLS キーストアパスワードなど) は、インストール単位のマスターキーを使用して AES-256-GCM で保存時に暗号化されます。
- STRICT プライバシーモードは、本物の HKDF (HMAC-SHA256 extract/expand) を使用してホストを匿名化します。BALANCED モードは、Cookie、トークン、認証ヘッダーを編集します。OFF モードはトラフィックをそのまま送信します。
- 外部 MCP サーバーの出力は、AI プロンプトに入る前に信頼境界マーカーでラップされ、信頼できないサーバーレスポンスからのプロンプトインジェクションを防ぎます。
設定は内部的にスキーマバージョン管理され (settings.schema.version)、安全なアップグレードのために読み込み時に追加的にマイグレーションされます。
要件
- Burp Suite Community または Professional (2023.12+)
- Java 21 (最新の Burp にランタイム用としてバンドルされています。ソースからのビルドには別途必要です)
- 少なくとも 1 つの AI バックエンドを設定 (上の表を参照)
ライセンス
このプロジェクトは MIT ライセンス の下でライセンスされています。
免責事項
事前の同意なしにターゲットを攻撃するために Custom AI Agent を使用することは違法です。すべての適用法を遵守するのはユーザーの責任です。開発者は、このツールの誤用やそれによって生じた損害について一切の責任を負いません。責任を持って使用してください。
コントリビューション
Issue とプルリクエストを歓迎します。開発セットアップとガイドラインについては CONTRIBUTING.md を、アーキテクチャの詳細については 開発者向けドキュメント を参照してください。