Burp Suite MCP Server Extension

Burp Suite MCP Server Extension

概要

Model Context Protocol（MCP）を使用して、Burp Suite を AI クライアントと連携させます。

プロトコルの詳細については、modelcontextprotocol.io をご覧ください。

機能

• MCP を通じて Burp Suite を AI クライアントに接続
• Claude Desktop の自動インストール
• パッケージ化された Stdio MCP プロキシサーバーが付属

使用方法

• Burp Suite に拡張機能をインストールします
• 拡張機能の設定で Burp MCP サーバーを設定します
• MCP クライアントが Burp SSE MCP サーバーまたは stdio プロキシを使用するよう設定します
• クライアントを通じて Burp を操作します！

インストール

前提条件

拡張機能をビルドしてインストールする前に、次の前提条件が満たされていることを確認してください。

1. Java：Java がインストールされ、システムの PATH から利用できる必要があります。ターミナルで java --version を実行すると確認できます。
2. jar コマンド：jar コマンドを実行でき、システムの PATH から利用できる必要があります。ターミナルで jar --version を実行すると確認できます。拡張機能のビルドとインストールに必要です。

拡張機能のビルド

1. リポジトリをクローン：MCP Server Extension のソースコードを取得します。

   git clone https://github.com/PortSwigger/mcp-server.git
   

2. プロジェクトディレクトリに移動：プロジェクトのルートディレクトリに移動します。

   cd mcp-server
   

3. JAR ファイルをビルド：Gradle を使用して拡張機能をビルドします。

   ./gradlew embedProxyJar
   

   このコマンドはソースコードをコンパイルし、build/libs/burp-mcp-all.jar に JAR ファイルとしてパッケージ化します。

Burp Suite への拡張機能の読み込み

1. Burp Suite を開く：Burp Suite アプリケーションを起動します。
2. 拡張機能タブにアクセス：Extensions タブに移動します。
3. 拡張機能を追加：
   • Add をクリックします。
   • Extension Type を Java に設定します。
   • Select file ... をクリックし、前の手順でビルドした JAR ファイルを選択します。
   • Next をクリックして拡張機能を読み込みます。

読み込みが成功すると、MCP Server Extension が Burp Suite で有効になります。

設定

拡張機能の設定

拡張機能は、Burp Suite の UI にある MCP タブから設定します。

• MCP サーバーの切り替え：Enabled チェックボックスで、MCP サーバーを有効にするかどうかを切り替えます。
• 設定の編集を有効化：Enable tools that can edit your config チェックボックスをオンにすると、Burp の設定ファイルを編集できるツールを MCP サーバーに公開できます。
• 詳細オプション：MCP サーバーのポートとホストを設定できます。デフォルトでは http://127.0.0.1:9876 で待ち受けます。

Claude Desktop クライアント

Claude で MCP Server Extension を十分に活用するには、Claude クライアントの設定を適切に行う必要があります。 拡張機能には、クライアントの設定を自動的に構成するインストーラーが用意されています。

1. 現在、Claude Desktop は必要なサービスに対して STDIO MCP サーバーのみをサポートしています。 この方法は Burp のようなデスクトップアプリには適していないため、代わりに Claude が Burp インスタンスを指すプロキシサーバーを起動します。 Burp インスタンスは、既知のポート（localhost:9876）でウェブサーバーをホストします。

2. Burp MCP サーバーを使用するよう Claude を設定する
   次のいずれかの方法で設定できます。

   • オプション 1：拡張機能からインストーラーを実行する これにより、Burp MCP サーバーが Claude Desktop の設定に追加されます。

   • オプション 2：設定ファイルを手動で編集する
     ~/Library/Application Support/Claude/claude_desktop_config.json にあるファイルを開き、次の内容に置き換えるか、更新します。

     {
       "mcpServers": {
         "burp": {
           "command": "<path to Java executable packaged with Burp>",
           "args": [
               "-jar",
               "/path/to/mcp/proxy/jar/mcp-proxy-all.jar",
               "--sse-url",
               "<your Burp MCP server URL configured in the extension>"
           ]
         }
       }
     }
     

3. Claude Desktop を再起動する - Burp が拡張機能を読み込んだ状態で実行されていることを確認してください。

手動インストール

MCP サーバーを手動でインストールする場合は、拡張機能の SSE サーバーを直接使うか、パッケージ化された Stdio プロキシサーバーを使います。

SSE MCP サーバー

SSE サーバーを直接使うには、設定済みのサーバー URL を MCP クライアントに指定します。

http://127.0.0.1:9876

Stdio MCP プロキシサーバー

プロキシサーバーのソースコードはこちらにあります：MCP Proxy Server

Stdio MCP サーバーのみをサポートする MCP クライアントに対応するため、この拡張機能には、SSE MCP サーバー拡張機能へのリクエストを転送するプロキシサーバーが同梱されています。

Stdio プロキシサーバーを使う場合は、拡張機能のインストーラーオプションを使ってプロキシサーバーの jar を抽出できます。 jar を取得したら、次のコマンドと引数をクライアント設定に追加します。

/path/to/packaged/burp/java -jar /path/to/proxy/jar/mcp-proxy-all.jar --sse-url http://127.0.0.1:9876

プロキシのソースを変更した場合は、拡張機能をパッケージ化する前に再ビルドし、このプロジェクトにコピーしてください。

# From mcp-proxy
./gradlew shadowJar
cp build/libs/mcp-proxy-all.jar /path/to/mcp-server/libs/mcp-proxy-all.jar

# From mcp-server
./gradlew embedProxyJar

ツールの作成／変更

ツールは src/main/kotlin/net/portswigger/mcp/tools/Tools.kt で定義されています。新しいツールを定義するには、LLM から渡される必要なパラメーターを含む、新しいシリアライズ可能なデータクラスを作成します。

ツール名は、パラメーターデータクラスから自動的に導出されます。LLM 用の説明も必要です。文字列または List<ContentBlock> を返して、LLM にデータを渡すことができます。

自動ページネーションをサポートするには、Paginated インターフェースを拡張します。