Burp Suite

🚀 MCP Server Extension

通過Model Context Protocol（MCP），將Burp Suite與AI客戶端集成，實現兩者的高效交互。用戶可藉助此擴展，在Burp Suite中利用AI的強大能力進行安全測試等工作。更多協議信息可訪問：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：啟動您的BurpSuite應用程序。
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複選框允許MCP服務器暴露可以編輯Burp配置文件的工具。
• 高級選項：您可以配置MCP服務器的端口和主機。默認情況下，它偵聽http://127.0.0.1:9876。

Claude Desktop客戶端

要充分利用MCP Server Extension與Claude結合使用，您需要適當配置您的Claude客戶端設置。擴展有一個安裝程序，可以自動為您配置客戶端設置。

1. 當前，Claude Desktop僅支持STDIO MCP服務器，該服務需要它。這種方法對於像Burp這樣的桌面應用程序來說並不理想，因此相反，Claude會啟動一個代理服務器，指向運行著MCP擴展的Burp實例，它在已知端口上託管一個Web服務器（localhost:9876）。
2. 配置Claude使用Burp MCP服務器
   您可以以以下兩種方式之一進行操作：
   • 選項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接口來添加自動分頁支持。