Bugbounty MCP Server

🚀 Bug Bounty MCP Server

Bug Bounty MCP Server 是一個簡潔、專注的服務器，包含漏洞賞金狩獵工作流和 REST API 端點，能高效助力漏洞賞金狩獵工作。

✨ 主要特性

• 架構簡潔：在保留核心功能的同時，去除了冗餘和不必要的依賴。
• 專注漏洞賞金：具備針對偵察、漏洞挖掘、業務邏輯測試、開源情報收集（OSINT）和文件上傳測試的專業工作流。
• REST API 端點：提供簡單的 HTTP API 用於工作流的生成和管理。
• 全面評估：可組合多個工作流，以進行完整的漏洞賞金評估。

🔧 技術細節

核心組件

• REST API 服務器 (src/server.py)：基於 Flask 的 HTTP API 服務器，提供漏洞賞金工作流端點。
• MCP 服務器 (src/mcp_server.py)：基於 FastMCP 的服務器，用於與 AI 代理進行通信。
• 漏洞賞金工作流：針對不同測試階段生成專業的工作流。
• 工具集成：集成了豐富的安全測試工具。

🚀 快速開始

1. 安裝依賴並啟動服務器

# 使用 uv 安裝依賴
uv sync

# 安裝開發依賴（可選）
uv sync --dev

# 設置預提交鉤子（開發時推薦）
uv run pre-commit install

# 啟動服務器
uv run src/server.py

# 或者使用環境變量
DEBUG=true BUGBOUNTY_MCP_PORT=8888 uv run src/server.py

# 或者使用啟動腳本
./start-server.sh --debug --port 8888

2. 測試 API

# 創建偵察工作流
curl -X POST http://127.0.0.1:8888/api/bugbounty/reconnaissance-workflow \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "program_type": "web"}'

📚 詳細文檔

配置

環境變量

• BUGBOUNTY_MCP_PORT：服務器端口（默認：8888）
• BUGBOUNTY_MCP_HOST：服務器主機（默認：127.0.0.1）
• DEBUG：啟用調試模式（默認：false）

💻 使用示例

# 使用默認配置啟動
uv run src/server.py

# 使用自定義配置啟動
DEBUG=true BUGBOUNTY_MCP_PORT=9999 BUGBOUNTY_MCP_HOST=0.0.0.0 uv run src/server.py

關鍵特性

1. 漏洞賞金工作流管理：為漏洞賞金狩獵的不同階段生成完整的工作流。
2. 漏洞優先級排序：基於影響和賞金潛力進行智能優先級排序。
3. 文件上傳測試：用於文件上傳漏洞測試的專業框架。
4. 開源情報集成：全面的開源情報收集工作流。
5. 業務邏輯測試：結構化的業務邏輯漏洞發現方法。

依賴項

項目使用 uv 進行快速、可靠的依賴管理：

核心依賴

• Flask：用於 REST API 的 Web 框架。
• FastMCP：MCP 服務器框架。
• Requests：HTTP 客戶端庫。
• Python 3.11+：核心運行時（支持 Python 3.11、3.12、3.13）

開發依賴

• Ruff：快速的 Python 代碼檢查器和格式化工具。
• Bandit：安全漏洞掃描器。
• Pydocstyle：文檔質量檢查器。
• Pyright：靜態類型檢查器。
• Pre-commit：Git 預提交鉤子框架

安裝依賴：

uv sync                # 僅安裝核心依賴
uv sync --dev         # 包含開發工具

添加新依賴：

uv add package-name

代碼質量

本項目通過自動化的預提交鉤子來保證代碼質量：

# 安裝預提交鉤子
uv run pre-commit install

# 對所有文件運行檢查
uv run pre-commit run --all-files

# 運行特定檢查
uv run ruff check          # 代碼檢查
uv run ruff format         # 代碼格式化
uv run bandit -c pyproject.toml # 安全掃描
uv run pydocstyle          # 文檔檢查

標準：

• 行長度：88 個字符
• 文檔：遵循 Google 文檔字符串約定
• 類型提示：公共 API 必須添加
• 安全：啟用 Bandit 安全掃描