Burp Suite MCP 服务器扩展

概述

使用模型上下文协议 (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，并且 java 命令应在系统的 PATH 环境变量中可用。您可以通过在终端中运行 java --version 来验证。
2. jar 命令：jar 命令必须可执行，并且应在系统的 PATH 环境变量中可用。您可以通过在终端中运行 jar --version 来验证。这是构建和安装扩展所必需的。

构建扩展

1. 克隆仓库：获取 MCP 服务器扩展的源代码。

   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 服务器扩展将在 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 将启动一个指向 Burp 实例的代理服务器，该实例在已知端口（localhost:9876）上托管一个 Web 服务器。

2. 配置 Claude 使用 Burp MCP 服务器 您可以通过两种方式完成此操作：

   • 选项 1：从扩展运行安装程序 这将把 Burp MCP 服务器添加到 Claude Desktop 的配置中。

   • 选项 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",
               "<您在扩展中配置的 Burp MCP 服务器 URL>"
           ]
         }
       }
     }
     

3. 重启 Claude Desktop——前提是 Burp 已运行并加载了扩展。

手动安装

如果您想手动安装 MCP 服务器，可以直接使用扩展的 SSE 服务器，或者使用打包的 Stdio 代理服务器。

SSE MCP 服务器

要直接使用 SSE 服务器，只需在您的客户端配置中提供服务器的 URL 即可。根据您的客户端以及在扩展中的配置，这可能包含或不包含 /sse 路径。

http://127.0.0.1:9876

或

http://127.0.0.1:9876/sse

Stdio MCP 代理服务器

代理服务器的源代码可在以下链接找到：MCP 代理服务器

为了支持仅支持 Stdio 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

创建/修改工具

工具定义在 src/main/kotlin/net/portswigger/mcp/tools/Tools.kt 文件中。要定义新工具，创建一个新的可序列化数据类，其中包含来自 LLM 的必要参数。

工具名称会自动从其参数数据类中派生。还需要为 LLM 提供描述。您可以返回字符串（或更丰富的 PromptMessageContents）以向 LLM 提供数据。

通过实现 Paginated 接口，可以添加自动分页支持。

Burp Suite MCP Server 快速上手指南

本指南帮助你将 Burp Suite 通过 Model Context Protocol (MCP) 集成到 AI 客户端（如 Claude Desktop），实现 AI 与渗透测试工具的联动。

环境准备

在开始之前，请确保你的系统满足以下要求：

1. Java 环境：必须安装 Java 并配置到系统环境变量 PATH 中。
   • 验证命令：java --version
2. Jar 工具：确保 jar 命令可用，用于构建扩展包。
   • 验证命令：jar --version
3. Burp Suite：已安装并可正常运行的 Burp Suite 专业版或社区版。
4. Git：用于克隆源代码仓库。

安装步骤

1. 获取源码与构建

打开终端，执行以下命令克隆仓库并构建扩展包：

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

构建成功后，生成的 JAR 文件位于：build/libs/burp-mcp-all.jar。

2. 加载扩展到 Burp Suite

1. 启动 Burp Suite。
2. 点击顶部菜单的 Extensions 标签页。
3. 点击 Add 按钮。
4. 在弹出窗口中：
   • Extension Type 选择 Java。
   • 点击 Select file ...，选择上一步生成的 burp-mcp-all.jar 文件。
   • 点击 Next 完成加载。

加载成功后，Burp 界面中将出现 MCP 配置标签页。

3. 配置 MCP 服务

在 Burp Suite 的 MCP 标签页中进行如下设置：

• Enabled：勾选以激活 MCP 服务器。
• Host/Port：默认监听 http://127.0.0.1:9876，通常无需修改。
• Enable tools that can edit your config：如需允许 AI 修改 Burp 配置，请勾选此项。

4. 配置 AI 客户端 (以 Claude Desktop 为例)

由于 Claude Desktop 主要支持 STDIO 模式的 MCP 服务，而 Burp 运行的是 SSE 服务，因此需要通过内置的代理进行连接。

方法一：使用自动安装器（推荐） 在 Burp 的 MCP 设置界面中，寻找并运行自动安装器选项，它将自动更新 Claude 的配置文件。

方法二：手动修改配置文件 如果自动安装失败，请手动编辑 Claude 配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

添加或更新以下内容（注意替换 <path to Java> 和 <path to proxy jar> 为实际路径）：

{
  "mcpServers": {
    "burp": {
      "command": "<path to Java executable packaged with Burp>",
      "args": [
          "-jar",
          "/path/to/mcp/proxy/jar/mcp-proxy-all.jar",
          "--sse-url",
          "http://127.0.0.1:9876"
      ]
    }
  }
}

注：mcp-proxy-all.jar 可通过扩展程序的 installer 选项提取，或从构建产物中查找。

配置完成后，重启 Claude Desktop（确保 Burp Suite 已在运行）。

基本使用

完成上述配置后，即可在 AI 对话框中与 Burp Suite 进行交互：

1. 启动顺序：先启动 Burp Suite 并确认 MCP 扩展已启用，再启动 Claude Desktop。
2. 发起请求：在 Claude 对话框中直接输入自然语言指令，例如：
   • “列出当前 Burp Target 站点地图中的所有域名。”
   • “对当前选中的请求执行主动扫描。”
   • “分析最近的扫描结果，找出高风险漏洞。”
3. 查看结果：AI 将通过 MCP 协议调用 Burp 的工具函数，并将执行结果直接返回给你。

现在，你已经成功将 Burp Suite 接入 AI 工作流，可以开始探索智能化的渗透测试辅助功能了。