MCP Zap Server

🚀 MCP-ZAP 服務器

MCP-ZAP 服務器是一個基於 Spring Boot 的應用程序，它將 OWASP ZAP 暴露為 MCP（模型上下文協議）服務器。藉助該服務器，任何與 MCP 兼容的 AI 代理（如 Claude Desktop、Cursor）都能協調 ZAP 操作，包括爬蟲、主動掃描、導入 OpenAPI 規範並生成報告。

⚠️ 重要提示

此項目目前處於開發階段，尚未準備好用於生產環境。其目的是為了教育用途，並演示模型上下文協議（MCP）與 OWASP ZAP 的能力。

✨ 主要特性

• MCP 服務器：將 ZAP 操作作為 MCP 工具暴露。
• OpenAPI 集成：可導入遠程或上傳的 OpenAPI 規範到 ZAP 並啟動主動掃描。
• 報告生成：能夠生成 HTML/JSON 報告，並可程序化地獲取內容。
• Docker 化：可通過 docker-compose 運行 ZAP 和 MCP 服務器容器。
• 安全：可配置 API 密鑰用於 ZAP（ZAP_API_KEY）和 MCP 服務器（MCP_API_KEY）。

🔧 技術細節

flowchart LR
  subgraph "Docker Compose"
    ZAP["OWASP ZAP (容器)"]
    MCP["MCP 服務器 (Spring Boot)"]
    Client["MCP 客戶端 (Open Web-UI)"]
  end
  OtherClient["MCP 客戶端 (Claude, Cursor)"] --> |HTTP/SSE + Bearer| MCP
  Client -->|HTTP/SSE + Bearer| MCP
  MCP -->|ZAP REST API| ZAP
  ZAP -->|掃描、警報、報告| MCP

🚀 快速開始

先決條件

• 安裝 Docker
• 安裝 Docker Compose

運行服務

1. 打開終端。
2. 切換到包含 docker-compose.yml 文件的項目目錄。
3. 運行以下命令以分 detached 模式啟動容器：

docker-compose up -d

4. 要查看特定服務的日誌，運行：

docker-compose logs <service_name>

服務概述

zap

• 鏡像：zaproxy/zap-stable
• 目的：在端口 8090 運行 OWASP ZAP daemon。
• 配置：
  • 禁用 API 密鑰。
  • 接受來自所有地址的請求。
  • 映射主機目錄 ${LOCAL_ZAP_WORKPLACE_FOLDER} 到容器路徑 /zap/wrk。

open-webui

• 鏡像：ghcr.io/open-webui/open-webui
• 目的：提供管理 ZAP 和 MCP 服務器的網絡界面。
• 配置：
  • 暴露端口 3000。
  • 使用命名卷持久化後端數據。

mcpo

• 鏡像：ghcr.io/open-webui/mcpo:main
• 目的：將任何 MCP 工具作為 OpenAPI 兼容的 HTTP 服務器暴露。僅用於 Open Web-UI。
• 配置：
  • 映射端口 9000。

mcp-zap

• 鏡像：ghcr.io/mcpgpt/mcp-zap:latest
• 目的：運行 MCP-ZAP 項目。
• 配置：
  • 設置環境變量 ${MCP_ZAP_OPENAPI} 指向 OpenAPI 文件路徑。
  • 設置環境變量 ${MCP_ZAP_API_KEY} 配置 API 密鑰。

💻 使用示例

Docker Compose 啟動

# 在項目目錄下運行以下命令啟動服務：
docker-compose up -d

# 訪問界面：
# Open Web-UI：http://localhost:3000

環境變量配置

MCP-ZAP 服務器

# 配置 OpenAPI 文件路徑（必填）
MCP_ZAP_OPENAPI=/path/to/openapi.json

# 可選，設置 API 密鑰
MCP_ZAP_API_KEY=your_api_key_here

具體使用案例

1. 創建一個簡單的 OpenAPI 規範文件 openapi.json

{
  "openapi": "3.0.0",
  "info": {
    "title": "示例 API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "http://localhost:8080"
    }
  ]
}

2. 啟動 MCP-ZAP 服務器

# 在項目目錄下運行以下命令啟動服務：
docker-compose up -d

# 確認服務運行狀態：
docker-compose ps

📚 詳細文檔

術語表

• MCP：模型上下文協議（Model Context Protocol）
• ZAP：OWASP ZAP（Zugzwang 的主動安全工具）
• OpenAPI：開放應用程序接口規範