Burp Suite MCP 服务器扩展

概述

通过 Model Context Protocol (MCP)，将 Burp Suite 集成到 AI 客户端中。

有关协议的更多信息，请访问：modelcontextprotocol.io

功能

• 将 Burp Suite 与 AI 客户端通过 MCP 连接
• 自动安装 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 将启动一个代理服务器指向运行着的 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 接口以添加自动分页支持。

将以上所有内容完整地翻译成中文，只返回翻译后的内容，不要有任何其他无关的信息。