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. 克隆倉庫：獲取 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 MCP 服務器擴展：

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 服務器擴展與 Claude，請正確配置您的 Claude 客戶端設置。該擴展帶有安裝程序，可以自動為您配置客戶端設置。

1. 目前，Claude Desktop 只支持 STDIO MCP 服務器對於所需服務。這種方法對於像 Burp 這樣的桌面應用程序來說並不理想，因此，Claude 將啟動一個代理服務器指向運行著的 Burp 實例，它託管一個 web 服務器，位於已知端口 (localhost:9876)。
2. 配置 Claude 使用 Burp MCP 服務器
   您可以通過以下兩種方式之一進行操作：
   • 選項 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 接口以添加自動分頁支持。