Burp Suite MCP Server Extension

🚀 Burp Suite MCP サーバ拡張

Model Context Protocol (MCP) を介して、Burp Suite を AI クライアントに統合します。

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

✨ 主な機能

• MCP を介して Burp Suite と AI クライアントを接続します。
• Claude Desktop を自動インストールします。
• パッケージ化された Stdio MCP 代理サーバを備えています。

🚀 クイックスタート

1. Burp Suite でこの拡張機能をインストールします。
2. 拡張機能の設定で、Burp MCP サーバを構成します。
3. MCP クライアントを構成して、Burp SSE MCP サーバまたは stdio 代理を使用するようにします。
4. クライアントを介して Burp とやり取りします！

📦 インストール

拡張機能のビルド

1. リポジトリをクローンする：MCP サーバ拡張機能のソースコードを取得します。

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

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

   cd burp-mcp
   

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 サーバ拡張機能が Burp Suite でアクティブになります。

📚 ドキュメント

拡張機能の構成

Burp Suite UI の MCP タブを使用して構成します。

• MCP サーバを有効にする：Enabled チェックボックスで、MCP サーバがアクティブかどうかを制御します。
• 構成編集ツールを有効にする：Enable tools that can edit your config チェックボックスで、MCP サーバが Burp 構成ファイルを編集できるツールを公開することを許可します。
• 高度なオプション：MCP サーバのポートとホストを構成できます。デフォルトでは、http://127.0.0.1:9876 でリッスンします。

Claude Desktop クライアント

MCP サーバ拡張機能と Claude を最大限に活用するには、Claude クライアントの設定を正しく構成してください。 この拡張機能にはインストーラが付属しており、クライアント設定を自動的に構成できます。

1. 現在、Claude Desktop は STDIO MCP サーバのみをサポートしています。 この方法は、Burp のようなデスクトップアプリケーションには理想的ではありません。そのため、Claude は、既知のポート (localhost:9876) で動作する Burp インスタンスを指す代理サーバを起動します。

2. Claude を Burp MCP サーバを使用するように構成する
   以下の 2 つの方法のいずれかで行うことができます。

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

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

     {
       "tools": {
         "burp_mcp": {
           "type": "mcp",
           "description": "A tool that interacts with the Burp Suite MCP server.",
           "parameters": {}
         }
       },
       "llm": {
         "temperature": 0.7,
         "max_tokens": 2048
       }
     }
     

ツールの作成 / 変更

ツールは src/main/kotlin/net/portswigger/mcp/tools/Tools.kt で定義されています。新しいツールを定義するには、LLM から必要なパラメータを含む新しいシリアライズ可能なデータクラスを作成します。ツール名は、そのパラメータデータクラスから自動的に派生します。また、LLM で使用するための説明を提供する必要があります。

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