Skip to content
Back to search

mcp-server

MCP Server for Burp

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/danielgallen--mcp-server/badge.svg)](/listings/danielgallen--mcp-server)

HTML

<a href="/listings/danielgallen--mcp-server"><img src="/api/listings/danielgallen--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

Ensure that the following prerequisites are met before building and installing the extension:

1. **Java**: Java must be installed and available in your system's PATH. You can verify this by running `java --version` in your terminal. 2. **jar Command**: The `jar` command must be executable and available in your system's PATH. You can verify this by running `jar --version` in your terminal. This is required for building and installing the extension.

Building the Extension

1. **Clone the Repository**: Obtain the source code for the MCP Server Extension.

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

2. **Navigate to the Project Directory**: Move into the project's root directory.

   cd mcp-server

3. **Build the JAR File**: Use Gradle to build the extension.

   ./gradlew embedProxyJar

This command compiles the source code and packages it into a JAR file located in `build/libs/burp-mcp-all.jar`.

Loading the Extension into Burp Suite

1. **Open Burp Suite**: Launch your Burp Suite application. 2. **Access the Extensions Tab**: Navigate to the `Extensions` tab. 3. **Add the Extension**: - Click on `Add`. - Set `Extension Type` to `Java`. - Click `Select file ...` and choose the JAR file built in the previous step. - Click `Next` to load the extension.

Upon successful loading, the MCP Server Extension will be active within Burp Suite.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 193 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Burp Suite MCP Server Extension
  2. ## Overview
  3. Integrate Burp Suite with AI Clients using the Model Context Protocol (MCP).
  4. For more information about the protocol visit: [modelcontextprotocol.io](https://modelcontextprotocol.io/)
  5. ## Features
  6. - Connect Burp Suite to AI clients through MCP
  7. - Automatic installation for Claude Desktop
  8. - Serves both Streamable HTTP (`/mcp`) and legacy SSE (`/`) transports
  9. - Comes with packaged Stdio MCP proxy server
  10. ## Usage
  11. - Install the extension in Burp Suite
  12. - Configure your Burp MCP server in the extension settings
  13. - Configure your MCP client to use the Burp SSE MCP server or stdio proxy
  14. - Interact with Burp through your client!
  15. ## Installation
  16. ### Prerequisites
  17. Ensure that the following prerequisites are met before building and installing the extension:
  18. 1. **Java**: Java must be installed and available in your system's PATH. You can verify this by running `java --version` in your terminal.
  19. 2. **jar Command**: The `jar` command must be executable and available in your system's PATH. You can verify this by running `jar --version` in your terminal. This is required for building and installing the extension.
  20. ### Building the Extension
  21. 1. **Clone the Repository**: Obtain the source code for the MCP Server Extension.
  22. ```
  23. git clone https://github.com/PortSwigger/mcp-server.git
  24. ```
  25. 2. **Navigate to the Project Directory**: Move into the project's root directory.
  26. ```
  27. cd mcp-server
  28. ```
  29. 3. **Build the JAR File**: Use Gradle to build the extension.
  30. ```
  31. ./gradlew embedProxyJar
  32. ```
  33. This command compiles the source code and packages it into a JAR file located in `build/libs/burp-mcp-all.jar`.
  34. ### Loading the Extension into Burp Suite
  35. 1. **Open Burp Suite**: Launch your Burp Suite application.
  36. 2. **Access the Extensions Tab**: Navigate to the `Extensions` tab.
  37. 3. **Add the Extension**:
  38. - Click on `Add`.
  39. - Set `Extension Type` to `Java`.
  40. - Click `Select file ...` and choose the JAR file built in the previous step.
  41. - Click `Next` to load the extension.
  42. Upon successful loading, the MCP Server Extension will be active within Burp Suite.
  43. ## Configuration
  44. ### Configuring the Extension
  45. Configuration for the extension is done through the Burp Suite UI in the `MCP` tab.
  46. - **Toggle the MCP Server**: The `Enabled` checkbox controls whether the MCP server is active.
  47. - **Enable config editing**: The `Enable tools that can edit your config` checkbox allows the MCP server to expose tools which can edit Burp configuration files.
  48. - **Advanced options**: You can configure the port and host for the MCP server. By default, it listens on `http://127.0.0.1:9876`.
  49. ### Claude Desktop Client
  50. To fully utilize the MCP Server Extension with Claude, you need to configure your Claude client settings appropriately.
  51. The extension has an installer which will automatically configure the client settings for you.
  52. 1. Currently, Claude Desktop only support STDIO MCP Servers
  53. for the service it needs.
  54. This approach isn't ideal for desktop apps like Burp, so instead, Claude will start a proxy server that points to the
  55. Burp instance,
  56. which hosts a web server at a known port (`localhost:9876`).
  57. 2. **Configure Claude to use the Burp MCP server**
  58. You can do this in one of two ways:
  59. - **Option 1: Run the installer from the extension**
  60. This will add the Burp MCP server to the Claude Desktop config.
  61. - **Option 2: Manually edit the config file**
  62. Open the file located at `~/Library/Application Support/Claude/claude_desktop_config.json`,
  63. and replace or update it with the following:
  64. ```json
  65. {
  66. "mcpServers": {
  67. "burp": {
  68. "command": "<path to Java executable packaged with Burp>",
  69. "args": [
  70. "-jar",
  71. "/path/to/mcp/proxy/jar/mcp-proxy-all.jar",
  72. "--sse-url",
  73. "<your Burp MCP server URL configured in the extension>"
  74. ]
  75. }
  76. }
  77. }
  78. ```
  79. 3. **Restart Claude Desktop** - assuming Burp is running with the extension loaded.
  80. ### Codex
  81. Codex connects to the extension's Streamable HTTP endpoint directly; no proxy jar or Java path is needed.
  82. #### Plugin (recommended)
  83. The Burp Suite MCP Server plugin sets up the connection and adds a skill that teaches Codex how to use the tools:
  84. which to reach for, how Burp's approval prompts behave and what to do when a call hangs.
  85. ```bash
  86. codex plugin marketplace add PortSwigger/mcp-server
  87. codex plugin add burp-suite-mcp-server@portswigger
  88. ```
  89. The plugin expects the extension on `http://127.0.0.1:9876`. If you changed the host or port, or want Codex to run
  90. the tools without asking (needed for non-interactive `codex exec` runs), override the server in
  91. `~/.codex/config.toml`. Give the full entry, including `url`:
  92. ```toml
  93. [mcp_servers.burp]
  94. url = "http://127.0.0.1:9876/mcp"
  95. default_tools_approval_mode = "approve"
  96. ```
  97. #### Without the plugin
  98. ```bash
  99. codex mcp add burp --url http://127.0.0.1:9876/mcp
  100. ```
  101. The skill lives in `plugins/burp-suite-mcp-server/skills/burp-mcp`; copy that folder into `~/.codex/skills/` to use
  102. it without the plugin.
  103. #### Approvals
  104. By default the extension asks for approval in Burp before sending HTTP requests or reading proxy history, so keep an
  105. eye on Burp while Codex works, or use the auto-approve options in the `MCP` tab.
  106. ## Manual installations
  107. If you want to install the MCP server manually you can either use the extension's SSE server directly or the packaged
  108. Stdio proxy server.
  109. ### Streamable HTTP MCP Server
  110. Clients that support the Streamable HTTP transport (e.g. Codex) can use the `/mcp` path on the configured server URL:
  111. ```
  112. http://127.0.0.1:9876/mcp
  113. ```
  114. ### SSE MCP Server
  115. To use the legacy SSE server directly, provide the configured server URL to your MCP client:
  116. ```
  117. http://127.0.0.1:9876
  118. ```
  119. ### Stdio MCP Proxy Server
  120. The source code for the proxy server can be found here: [MCP Proxy Server](https://github.com/PortSwigger/mcp-proxy)
  121. In order to support MCP Clients which only support Stdio MCP Servers, the extension comes packaged with a proxy server for
  122. passing requests to the SSE MCP server extension.
  123. If you want to use the Stdio proxy server you can use the extension's installer option to extract the proxy server jar.
  124. Once you have the jar you can add the following command and args to your client configuration:
  125. ```
  126. /path/to/packaged/burp/java -jar /path/to/proxy/jar/mcp-proxy-all.jar --sse-url http://127.0.0.1:9876
  127. ```
  128. If you modify the proxy source, rebuild and copy it into this project before packaging the extension:
  129. ```bash
  130. # From mcp-proxy
  131. ./gradlew shadowJar
  132. cp build/libs/mcp-proxy-all.jar /path/to/mcp-server/libs/mcp-proxy-all.jar
  133. # From mcp-server
  134. ./gradlew embedProxyJar
  135. ```
  136. ### Creating / modifying tools
  137. Tools are defined in `src/main/kotlin/net/portswigger/mcp/tools/Tools.kt`. To define new tools, create a new serializable
  138. data class with the required parameters which will come from the LLM.
  139. The tool name is auto-derived from its parameters data class. A description is also needed for the LLM. You can return
  140. a string or a `List<ContentBlock>` to provide data back to the LLM.
  141. Extend the Paginated interface to add auto-pagination support.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.