Skip to content
Back to search

BurpSuite-MCP-Server

BurpSuite MCP Server: A powerful Model Context Protocol (MCP) server implementation for BurpSuite, providing programmatic access to Burp's core functionalities.

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/x3r0k--burpsuite-mcp-server/badge.svg)](/listings/x3r0k--burpsuite-mcp-server)

HTML

<a href="/listings/x3r0k--burpsuite-mcp-server"><img src="/api/listings/x3r0k--burpsuite-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.

1. **Clone the repository**

git clone https://github.com/X3r0K/BurpSuite-MCP-Server.git
cd BurpSuite-MCP-Server

1. **Install Dependencies**

pip install -r requirements.txt

2. **Configure Environment**

# Copy .env.example to .env
cp .env.example .env

# Update the values in .env
BURP_API_KEY=Your_API_KEY
BURP_API_HOST=localhost
BURP_API_PORT=1337
BURP_PROXY_HOST=127.0.0.1
BURP_PROXY_PORT=8080
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8000

3. **Start the Server**

python main.py

The server will start on http://localhost:8000

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 · 233 lines

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

  1. # 🛡️ BurpSuite MCP Server
  2. A powerful Model Context Protocol (MCP) server implementation for BurpSuite, providing programmatic access to Burp's core functionalities.
  3. <a href="https://glama.ai/mcp/servers/@X3r0K/BurpSuite-MCP-Server">
  4. <img width="380" height="200" src="https://glama.ai/mcp/servers/@X3r0K/BurpSuite-MCP-Server/badge" />
  5. </a>
  6. [![MseeP.ai Security Assessment Badge](https://mseep.net/mseep-audited.png)](https://mseep.ai/app/x3r0k-burpsuite-mcp-server)
  7. [![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
  8. [![FastAPI](https://img.shields.io/badge/FastAPI-0.104.1-green.svg)](https://fastapi.tiangolo.com/)
  9. [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
  10. ## 🚀 Features
  11. ### 🔄 Proxy Tool
  12. - Intercept and modify HTTP/HTTPS traffic
  13. - View and manipulate requests/responses
  14. - Access proxy history
  15. - Real-time request/response manipulation
  16. ```bash
  17. # Intercept a request
  18. curl -X POST "http://localhost:8000/proxy/intercept" \
  19. -H "Content-Type: application/json" \
  20. -d '{
  21. "url": "https://example.com",
  22. "method": "GET",
  23. "headers": {"User-Agent": "Custom"},
  24. "intercept": true
  25. }'
  26. # View proxy history
  27. curl "http://localhost:8000/proxy/history"
  28. ```
  29. ### 🔍 Scanner Tool
  30. - Active and passive scanning
  31. - Custom scan configurations
  32. - Real-time issue tracking
  33. - Scan status monitoring
  34. ```bash
  35. # Start a new scan
  36. curl -X POST "http://localhost:8000/scanner/start" \
  37. -H "Content-Type: application/json" \
  38. -d '{
  39. "target_url": "https://example.com",
  40. "scan_type": "active",
  41. "scan_configurations": {
  42. "scope": "strict",
  43. "audit_checks": ["xss", "sqli"]
  44. }
  45. }'
  46. # Check scan status
  47. curl "http://localhost:8000/scanner/status/scan_1"
  48. # Stop a scan
  49. curl -X DELETE "http://localhost:8000/scanner/stop/scan_1"
  50. ```
  51. ### 📝 Logger Tool
  52. - Comprehensive HTTP traffic logging
  53. - Advanced filtering and search
  54. - Vulnerability detection
  55. - Traffic analysis
  56. - Suspicious pattern detection
  57. ```bash
  58. # Get filtered logs
  59. curl "http://localhost:8000/logger/logs?filter[method]=POST&filter[status_code]=200"
  60. # Search logs
  61. curl "http://localhost:8000/logger/logs?search=password"
  62. # Get vulnerability analysis
  63. curl "http://localhost:8000/logger/vulnerabilities"
  64. # Get comprehensive analysis
  65. curl "http://localhost:8000/logger/analysis"
  66. # Clear logs
  67. curl -X DELETE "http://localhost:8000/logger/clear"
  68. curl "http://localhost:8000/logger/vulnerabilities/severity"
  69. ```
  70. ### 🎯 Vulnerability Detection
  71. Automatically detects multiple types of vulnerabilities:
  72. - 🔥 XSS (Cross-Site Scripting)
  73. - 💉 SQL Injection
  74. - 🗂️ Path Traversal
  75. - 📁 File Inclusion
  76. - 🌐 SSRF (Server-Side Request Forgery)
  77. - 📄 XXE (XML External Entity)
  78. - 🔒 CSRF (Cross-Site Request Forgery)
  79. - 🔄 Open Redirect
  80. - ⚡ Command Injection
  81. ## 🛠️ Setup
  82. 1. **Clone the repository**
  83. ```bash
  84. git clone https://github.com/X3r0K/BurpSuite-MCP-Server.git
  85. cd BurpSuite-MCP-Server
  86. ```
  87. 1. **Install Dependencies**
  88. ```bash
  89. pip install -r requirements.txt
  90. ```
  91. 2. **Configure Environment**
  92. ```bash
  93. # Copy .env.example to .env
  94. cp .env.example .env
  95. # Update the values in .env
  96. BURP_API_KEY=Your_API_KEY
  97. BURP_API_HOST=localhost
  98. BURP_API_PORT=1337
  99. BURP_PROXY_HOST=127.0.0.1
  100. BURP_PROXY_PORT=8080
  101. MCP_SERVER_HOST=0.0.0.0
  102. MCP_SERVER_PORT=8000
  103. ```
  104. 3. **Start the Server**
  105. ```bash
  106. python main.py
  107. ```
  108. The server will start on http://localhost:8000
  109. ## 📊 Analysis Features
  110. ### Traffic Analysis
  111. - Total requests count
  112. - Unique URLs
  113. - HTTP method distribution
  114. - Status code distribution
  115. - Content type analysis
  116. - Average response time
  117. ### Vulnerability Analysis
  118. - Vulnerability type summary
  119. - Top vulnerable endpoints
  120. - Suspicious patterns
  121. - Real-time vulnerability detection
  122. ### Log Filtering
  123. - By HTTP method
  124. - By status code
  125. - By URL pattern
  126. - By content type
  127. - By content length
  128. - By time range
  129. - By vulnerability type
  130. ## 🔒 Security Considerations
  131. 1. Run in a secure environment
  132. 2. Configure appropriate authentication
  133. 3. Use HTTPS in production
  134. 4. Keep BurpSuite API key secure
  135. 5. Monitor and audit access
  136. ## 📚 API Documentation
  137. For detailed API documentation, visit:
  138. - Swagger UI: http://localhost:8000/docs
  139. - ReDoc: http://localhost:8000/redoc
  140. ![image](https://github.com/user-attachments/assets/a9af7fb9-b840-40ef-b8b7-b24a9bcbc72a)
  141. ## Cursor Integration
  142. The MCP server is configured to work seamlessly with Cursor IDE. The `.cursor` directory contains all necessary configuration files:
  143. ### Configuration Files
  144. 1. `settings.json`: Contains MCP server configuration
  145. - Server host and port settings
  146. - Endpoint configurations
  147. - BurpSuite proxy settings
  148. - Logger settings
  149. - Python interpreter path
  150. 2. `tasks.json`: Defines common tasks
  151. - Start MCP Server
  152. - Run Vulnerability Tests
  153. - Check Vulnerabilities
  154. 3. `launch.json`: Contains debugging configurations
  155. - Debug MCP Server
  156. - Debug Vulnerability Tests
  157. ### Using in Cursor
  158. 1. Open the project in Cursor
  159. 2. The MCP server configuration will be automatically loaded
  160. 3. Access features through:
  161. - Command Palette (Ctrl+Shift+P) for running tasks
  162. - Debug menu for debugging sessions
  163. - Automatic Python interpreter configuration
  164. The server will be accessible at `http://localhost:8000` with the following endpoints:
  165. - `/proxy/intercept` for request interception
  166. - `/logger` for logging functionality
  167. - `/logger/vulnerabilities/severity` for vulnerability analysis
  168. ![image](https://github.com/user-attachments/assets/7e006b2a-a9f7-4d09-85da-fd6fea5d352c)
  169. ![image](https://github.com/user-attachments/assets/e3376c42-5966-4fe8-a1d0-08916bd60b06)
  170. ## 📝 License
  171. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  172. ## 🙏 Acknowledgments
  173. - [BurpSuite](https://portswigger.net/burp) - The original security testing tool
  174. - [FastAPI](https://fastapi.tiangolo.com/) - The web framework used
  175. - [Python](https://www.python.org/) - The programming language used

Ratings and comments

Sign in to rate this skill.

Sign in

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