convez.ai
MCP ServerSegurançaAvançado
zalakamal08

Burp MCP Server

zalakamal08/burp-mcp-server

Integra Burp Suite com agentes Claude para testes de segurança automatizados

Ver no GitHub
InicialPluginScore · de 0 a 100

Extensão para Burp Suite que expõe suas ferramentas a agentes de IA via Model Context Protocol (MCP). Permite que Claude e outros agentes executem testes de segurança, manipulem requisições HTTP e acessem histórico de proxy programaticamente.

Instalação

$npx convez-ai zalakamal08/burp-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 meses
Versão
v1.2.6
Issues abertas
0
Contribuidores
0

Casos de uso

  • Automação de testes de penetração via agentes de IA
  • Manipulação inteligente de requisições HTTP em Repeater
  • Análise e filtragem de histórico de proxy por regex
  • Execução de verificações de segurança em ciclos de desenvolvimento

Veredito

Ferramenta especializada e bem implementada para integrar Burp Suite com agentes Claude em fluxos de segurança. Requer conhecimento técnico em testes de penetração e configuração MCP, mas oferece automação significativa para profissionais de segurança ofensiva.

README

A tradução para o português deste README ainda está na fila.

Burp MCP Server

A Burp Suite extension that exposes Burp tooling to AI agents via the Model Context Protocol.

🤖 Agent skill: This repo ships a Claude Code skill (SKILL.md) that teaches AI agents how to use these tools efficiently. Install it into your Claude Code skills directory with one line:

curl -fsSL https://raw.githubusercontent.com/zalakamal08/burp-mcp-server/main/install-skill.sh | bash

The installer pulls SKILL.md from GitHub into ~/.claude/skills/burp-mcp/. Once installed it auto-loads when you use the mcp__burp__* tools, or invoke it explicitly with /burp-mcp.

Installation

Download

Grab the latest JAR from the Releases page.

Load into Burp Suite

  1. Open Burp Suite → Extensions tab → Add
  2. Set Extension Type to Java
  3. Select the downloaded JAR → Next

The extension adds an MCP tab to Burp Suite.


Configuration

In the MCP tab:

  • Enable/Disable toggle — starts or stops the MCP server
  • Host / Port — default is 0.0.0.0:9876
  • Exposed Tools — check/uncheck which tools are visible to the AI agent. Disable the extension first to edit. Use Select All / Deselect All for quick changes.

Connecting an AI Client

The extension runs an SSE MCP server. Most desktop AI clients need a Stdio proxy to talk to it. Extract the proxy JAR from the Installation section of the MCP tab, then configure your client.

Claude Code CLI (~/.claude.json)

{
  "mcpServers": {
    "burp": {
      "command": "/usr/bin/java",
      "args": [
        "-jar",
        "/home/kali/mcp-proxy.jar",
        "--sse-url",
        "http://X.X.X.X:9876"
      ]
    }
  }
}

Replace X.X.X.X with your Burp machine's IP and /home/kali/mcp-proxy.jar with the path where you extracted the proxy JAR.

Claude Desktop (claude_desktop_config.json)

OSConfig file location
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "burp": {
      "command": "/usr/bin/java",
      "args": [
        "-jar",
        "/path/to/mcp-proxy.jar",
        "--sse-url",
        "http://X.X.X.X:9876"
      ]
    }
  }
}

The Install for Claude Desktop button in the MCP tab does this automatically.

Direct SSE (clients that support SSE natively)

http://X.X.X.X:9876

or

http://X.X.X.X:9876/sse

Available Tools

Repeater

ToolDescription
create_repeater_tabOpen a new Repeater tab with a given request
list_repeater_tabsList all open Repeater tabs (index + name)
get_repeater_tabGet the current request and last response from a tab
set_repeater_tab_requestWrite new request text into a tab
send_repeater_tab_requestSend the tab's request through Burp's HTTP engine
list_repeater_tab_historyList all previously sent requests in a tab
get_repeater_tab_history_itemGet request + response for a specific history entry

Proxy

ToolDescription
get_proxy_http_historyPaginated HTTP proxy history
get_proxy_http_history_regexFilter HTTP history by URL regex
get_proxy_http_history_itemGet a single history item by index
get_proxy_websocket_historyPaginated WebSocket history
get_proxy_websocket_history_regexFilter WebSocket history by regex
set_proxy_intercept_stateTurn proxy intercept on or off
search_proxy_historyFilter history by status code, method, Content-Type, or body keyword (AND logic)

HTTP

ToolDescription
send_http1_requestSend an HTTP/1.1 request through Burp
send_http2_requestSend an HTTP/2 request through Burp

Scope

ToolDescription
is_in_scopeCheck if a URL is in scope
add_to_scopeAdd a URL to scope
remove_from_scopeRemove a URL from scope

Site Map

ToolDescription
get_site_mapGet the full site map
get_site_map_for_urlGet site map entries for a specific URL

Scanner (Burp Suite Pro only)

ToolDescription
get_scanner_issuesList scanner findings
start_active_scanStart an active scan
start_passive_scanStart a passive scan
generate_collaborator_payloadGenerate a Burp Collaborator payload
get_collaborator_interactionsPoll Collaborator for interactions

Intruder

ToolDescription
send_to_intruderSend a request to Intruder

Configuration

ToolDescription
output_project_optionsExport project options as JSON
output_user_optionsExport user options as JSON
set_project_optionsSet project options from JSON
set_user_optionsSet user options from JSON
set_task_execution_engine_statePause or resume the task execution engine

Utilities

ToolDescription
url_encodeURL-encode a string
url_decodeURL-decode a string
base64_encodeBase64-encode a string
base64_decodeBase64-decode a string
generate_random_stringGenerate a random string
extract_from_responseExtract all regex matches from an HTTP response string (supports capture groups)

Editor

ToolDescription
get_active_editor_contentsRead the active Burp message editor
set_active_editor_contentsWrite to the active Burp message editor

Building from Source

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

Output: build/libs/burp-mcp-<version>-all.jar

Adding or Modifying Tools

  • Tool logic: src/main/kotlin/net/portswigger/mcp/tools/Tools.kt
  • Tool list (for the UI panel): src/main/kotlin/net/portswigger/mcp/config/ToolDefinitions.kt
  • Implement a @Serializable data class for the parameters, register it inside registerTools, and add an entry to ToolDefinitions. Implement Paginated for auto-pagination support.
Ver o original no GitHub

Bom para

Relacionados