Версия: 1.2.0

MCP-ASD - это расширение Burp Suite (Montoya API), предназначенное для идентификации, отображения и тестирования поверхности атаки серверов протокола Model Context Protocol (MCP).

Он обеспечивает мост между инструментами синхронного тестирования Burp (Repeater, Intruder, Scanner) и асинхронным, постоянным характером соединений MCP (SSE & WebSockets). Это позволяет специалистам по безопасности проводить аудит MCP Tools, Resources и Prompts с использованием стандартных рабочих процессов веб-тестирования.

Особенности

Поддержка нескольких протоколов: ** Полная поддержка событий, отправленных сервером (SSE), WebSockets (ws/wss) и HTTP POST-только для серверов, которые не поддерживают GET/SSE. ** Автооткрытие конечной точки:** Автоматическое обнаружение конечных точек MCP, включая обнаружение защищенных конечных точек, требующих аутентификации. ** Перечисление параметров поверхности:** Автоматически обнаруживает и визуализирует Инструменты, Ресурсы и Схемы, включая извлечение схемы для аргументов.

• ** Синхронное соединение: ** Обеспечивает бесшовное использование Burp Repeater и Intruder путем обработки асинхронной корреляции ID и управления сеансами. ** Поколение прототипов** Автоматически генерирует действительные полезные нагрузки JSON-RPC на основе обнаруженных схем инструментов.

MCP Attack Surface Detector (MCP-ASD)

Version: 1.2.0

MCP-ASD is a Burp Suite extension (Montoya API) designed to identify, map, and test the attack surface of Model Context Protocol (MCP) servers.

It provides a bridge between Burp’s synchronous testing tools (Repeater, Intruder, Scanner) and the asynchronous, persistent nature of MCP connections (SSE & WebSockets). This allows security professionals to audit MCP Tools, Resources, and Prompts using standard web testing workflows.

Features

• Multi-Protocol Support: Full support for Server-Sent Events (SSE), WebSockets (ws/wss), and HTTP POST-only transport (for servers that don’t support GET/SSE).
• Endpoint Auto-Discovery: Automated detection of MCP endpoints, including detection of protected endpoints that require authentication.
• Attack Surface Enumeration: Automatically discovers and visualizes Tools, Resources, and Prompts, including schema extraction for arguments.
• Synchronous Bridging: Enables seamless use of Burp Repeater and Intruder by handling asynchronous ID correlation and session management.
• Prototype Generation: Automatically generates valid JSON-RPC payloads based on discovered tool schemas.
• Authentication & mTLS: Support for custom HTTP headers (OAuth Bearer tokens, API keys) and mTLS client certificates (PKCS#12).
• Native Integration: Reports discovered MCP servers directly to Burp’s Target and Dashboard.
• Advanced Detection: Includes passive monitoring and active probing for MCP servers on discovered domains.
• Auth Gateway Detection: Detects MCP endpoints behind authentication gateways (Zscaler, OAuth, SAML, SSO) by recognizing redirect patterns to auth endpoints, including URL-encoded origurl parameters.

Installation

Prerequisites

• Java JDK 21+ (to build)
• Burp Suite Professional or Community (2025.6+)
  • MCP server detection (passive and active checks) runs through Burp Scanner and requires Burp Suite Professional. Everything else works in Community.

Building from Source

Note: There is a precompiled .jar at:
https://github.com/hoodoer/MCP-ASD/releases/tag/v1.0

git clone https://github.com/your-repo/mcp-asd.git
cd mcp-asd
./gradlew shadowJar

The resulting JAR will be located at build/libs/mcp-asd.jar.

Loading the Extension

1. Open Burp Suite.
2. Navigate to Extensions -> Installed.
3. Click Add.
4. Select Java and browse to the generated mcp-asd.jar.

Usage

1. Connection Management

• Use the New Connection button in the MCP-ASD tab to connect to a server.
• The Auto-Detect Endpoints feature identifies common MCP paths.
• Connection settings (host, port, headers, certificates) are persisted for the duration of the session.
• Cancel Button: If a connection attempt hangs or takes too long, use the Cancel button to abort the handshake and reset the interface.