ZAP MCP

🚀 ZAP - MCP：模型上下文協議用於OWASP ZAP

ZAP - MCP藉助模型上下文協議（MCP），實現了OWASP ZAP與AI模型的強大集成。它讓AI模型能夠直接調用ZAP的掃描功能，有力推動了基於AI的安全測試發展。

🚀 快速開始

ZAP - MCP作為橋樑，連接AI模型（如Claude）與OWASP ZAP，實現自動化安全測試與分析。它採用客戶機 - 服務器架構，ZAP - MCP作為服務器，通過MCP協議公開標準化功能，供AI模型直接調用。

✨ 主要特性

• 基於AI的安全測試：支持AI模型開展安全掃描與分析。
• 即時掃描監控：跟蹤掃描進度，即時接收警報。
• 自動化分析：生成安全報告與建議。
• 靈活的集成：可通過MCP協議與多種AI模型兼容。
• WebSocket通信：實現即時更新與交互。

📦 安裝指南

先決條件

• Python 3.8+
• 在本地或遠程運行的OWASP ZAP
• Claude桌面應用程序（或其他MCP兼容客戶端）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/tazer/ZAP-MCP.git
cd ZAP-MCP

2. 安裝依賴項：

pip install -r requirements.txt

3. 設置MCP服務器：

./setup_mcp.sh

4. 配置ZAP - MCP：
   • 將claude_desktop_config.json複製到Claude應用程序的配置目錄中。
   • 在配置文件中更新ZAP API密鑰和URL。

💻 使用示例

基礎用法

啟動MCP服務器

mcp-server --config claude_desktop_config.json --model-dir ./models

配置Claude桌面應用程序

• 打開Claude應用程序設置。
• 啟用MCP服務器集成。
• 將WebSocket URL設置為：ws://localhost:7456/ws

開始使用ZAP - MCP

• 此時，Claude應用程序即可訪問ZAP掃描工具。
• 可請求安全掃描，獲取警報並生成報告。

高級用法

MCP服務器公開了以下特定的ZAP工具：

• start_scan：開始針對目標URL的新ZAP掃描。
• get_scan_status：檢查正在運行的掃描狀態。
• get_alerts：從當前掃描中獲取所有警報。
• get_scan_summary：獲取當前掃描的摘要。

📚 詳細文檔

配置文件說明

claude_desktop_config.json文件包含所有必要的設置：

{
    "mcp_server": {
        "host": "localhost",
        "port": 7456,
        "model": "claude-instant-v1",
        "max_tokens": 1000,
        "temperature": 0.7,
        "zap_api_key": "your-zap-api-key",
        "zap_url": "http://localhost:8080"
    },
    "local_models": {
        "path": "./models",
        "prefer_local": true
    },
    "zap_settings": {
        "scan_timeout": 300,
        "max_concurrent_scans": 5,
        "alert_threshold": "HIGH",
        "scan_policy": "default"
    }
}

開發相關

該項目使用Cursor AI開發，Cursor AI是一個智能編碼助手，有助於優化開發流程並確保代碼質量。

📄 許可證

此項目根據MIT許可證發佈，詳情請參閱LICENSE文件。

👨‍💻 作者

• TAZER - 初始工作和維護