Burp Suite

🚀 MCP Server Extension

このプロジェクトは、Model Context Protocol（MCP）を通じてBurp SuiteとAIクライアントを統合する拡張機能です。MCPに関する詳細情報は、modelcontextprotocol.ioをご覧ください。

✨ 主な機能

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

📦 インストール

拡張機能のビルド

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

   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 Server ExtensionがBurp Suite内で有効になります。

🚀 クイックスタート

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

📚 ドキュメント

拡張機能の設定

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クライアント

MCP Server ExtensionとClaudeを組み合わせて使用するには、Claudeクライアントの設定を適切に構成する必要があります。拡張機能には、クライアント設定を自動的に構成するインストーラーが付属しています。

1. 現在、Claude DesktopはSTDIO MCPサーバーのみをサポートしています。 このサービスが必要です。この方法はBurpのようなデスクトップアプリケーションには理想的ではないため、代わりにClaudeはMCP拡張機能を実行しているBurpインスタンスを指す代理サーバーを起動します。これは既知のポート（localhost:9876）でWebサーバーをホストします。

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

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

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

     {
       "mcpServers": {
         "burp": {
           "command": "<包含Burp的Java可执行文件的路径>",
           "args": [
               "-jar",
               "/path/to/mcp/proxy/jar/mcp-proxy-all.jar",
               "--sse-url",
               "<http://127.0.0.1:9876>"
           ]
         }
       }
     }
     

ツールの作成/変更

ツールはsrc/main/kotlin/net/portswigger/mcp/tools/Tools.ktで定義されています。新しいツールを定義するには、LLMが必要とするパラメータを含む新しいシリアライズ可能なデータクラスを作成します。ツール名はそのパラメータデータクラスから自動的に生成されます。また、LLMに説明を提供する必要があります。文字列（またはその他のより豊富なPromptMessageContents）を返すことで、LLMにより多くのデータを提供することができます。

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