企业官网建设流程全解析

mcp-server（MCP Server for Burp）是 PortSwigger 官方出品的 Burp Suite 扩展，它通过Model Context Protocol（MCP）把 Burp Suite 接入 AI 客户端，让 Claude Desktop 等 AI 助手直接读取并操作 Burp 的代理数据、扫描结果。本文以 5 个步骤带你完成：构建 JAR → 加载扩展 → 配置服务器 → 一键安装到 Claude → 重启验证，全程无需手写一行配置代码。

一、认识 mcp-server 扩展

在动手之前，先了解它解决了什么问题：

• 连接方式：扩展在 Burp 内启动一个 SSE 类型的 MCP Server，默认监听http://127.0.0.1:9876
• 自动安装：内置 Claude Desktop 一键安装器，自动改写客户端的 MCP 配置文件
• 自带代理：打包了 Stdio MCP 代理（libs/mcp-proxy-all.jar），解决 Claude Desktop 只支持 Stdio 协议的问题

扩展的入口在 ExtensionBase.kt，加载后会在 Burp 顶部新增一个MCP标签页，所有配置都在这里完成。

二、第一步：准备环境并构建 JAR

1. 环境前置检查

构建前请确认系统中已安装 Java 与jar命令（项目使用 Java 21 工具链，见 gradle.properties）：

java --version jar --version

2. 克隆仓库

git clone https://gitcode.com/gh_mirrors/mcpserver1/mcp-server cd mcp-server

3. 使用 Gradle 构建

./gradlew embedProxyJar

该命令（定义于 BappManifest.bmf 的BuildCommand）会编译 Kotlin 源码，并把 MCP 代理一起打包，产物位于：

build/libs/burp-mcp-all.jar

💡 构建失败时先确认JAVA_HOME是否指向 JDK 21 及以上版本。

三、第二步：将扩展加载到 Burp Suite

1. 启动 Burp Suite（Pro 或 Community 版本均可）
2. 打开Extensions标签页
3. 点击Add，将Extension Type设置为Java
4. 点击Select file ...选择上一步生成的burp-mcp-all.jar
5. 点击Next完成加载

加载成功后，Burp 界面顶部会出现新的MCP标签页，这就是扩展的配置中心（UI 代码见 ConfigUi.kt）。

四、第三步：配置 MCP 服务器

进入MCP标签页，你会看到以下关键选项：

服务器实际由 Ktor 框架托管，启动/停止逻辑见 KtorServerManager.kt。

⚠️ 注意：修改主机或端口后，需要重新执行第四步的安装，否则 AI 客户端连接的还是旧地址。

五、第四步：一键安装到 Claude Desktop

由于 Claude Desktop 只支持 Stdio 协议的 MCP Server，而 Burp 是常驻桌面应用，扩展采用的方案是：Claude 启动一个本地代理进程，由代理转发请求到 Burp 的 SSE 服务器。

在 MCP 标签页的 Installation 区域，点击Install to Claude Desktop（对应实现见 Provider.kt），安装器会自动完成：

1. 从扩展中提取mcp-proxy-all.jar代理文件
2. 写入claude_desktop_config.json，生成形如以下的burp条目：

{ "mcpServers": { "burp": { "command": "<Burp 自带的 Java 可执行文件路径>", "args": ["-jar", "<代理jar路径>/mcp-proxy-all.jar", "--sse-url", "http://127.0.0.1:9876"] } } }

如果你更喜欢手动配置，也可以直接编辑~/Library/Application Support/Claude/claude_desktop_config.json，内容如上所示。更多细节可参考 README.md 的Manual installations章节。

六、第五步：重启 Claude 并验证对话

1. 确认 Burp Suite 已启动且扩展处于启用状态

2. 重启 Claude Desktop

3. 打开对话窗口，直接提问，例如：

   • "查看当前 Proxy 中最近的几个请求"
   • "帮我总结最近一次响应里的状态码分布"

Claude 会调用扩展暴露的 MCP 工具获取真实数据并回答，工具清单定义在 Tools.kt。

常见问题速查

• Claude 连不上 Burp：检查Enabled开关是否打开，--sse-url是否与扩展中配置的端口一致
• 修改端口后不生效：重新点击安装按钮刷新 Claude 的配置
• 想支持 SSE 直连的客户端：直接在客户端填入http://127.0.0.1:9876/sse即可，无需代理

七、进阶方向

完成 5 步后，你可以继续探索：

• 扩展自定义工具：在 Tools.kt 中新增一个可序列化的参数数据类，即可向 LLM 暴露新工具，并可通过实现Paginated接口获得自动分页能力
• 安全策略：数据访问与 HTTP 请求的访问控制分别在 DataAccessSecurity.kt 和 HttpRequestSecurity.kt 中，建议按需收紧
• 自动批准目标：在 MCP 标签页的 Auto-approve Targets 面板中，可预先授权 AI 访问特定域名，减少反复确认

至此，Burp 与 Claude 的对话通道已经打通。从./gradlew embedProxyJar到第一次向 Claude 提问，整个过程不超过 10 分钟，快去试试让 AI 帮你分析流量吧 🚀