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接口来添加自动分页支持。