de en es ja ko ru zh

io.github.pierre3/zap-mcp

Name: io.github.pierre3/zap-mcp
Author: pierre3

by pierre3

Overview Schema Source Related Servers Discussions Admin

Hybrid

dotnet-zap-mcp

NuGet NuGet Downloads Release

OWASP ZAP 用の MCP (Model Context Protocol) サーバーです。AI エージェント (Claude、GitHub Copilot など) が MCP 経由で ZAP の脆弱性スキャンを操作できるようにします。

特徴

OWASP ZAP を制御するための 45 個の MCP ツール (スキャン、アラート、スパイダー、Ajax スパイダー、コンテキスト、認証、レポートなど)
組み込みの Docker Compose 管理 (1 回のツール呼び出しで ZAP を起動/停止)
ゼロ設定セットアップ: API キーを自動生成し、Docker アセットを展開
あらゆる MCP 互換クライアント (Claude Desktop、VS Code など) で動作

Related MCP server: Grype MCP Server

インストール

dotnet tool install -g dotnet-zap-mcp

前提条件

.NET 10 SDK
docker compose 対応の Docker (Docker Engine または Docker Desktop) (組み込みの ZAP コンテナ管理用)

設定

ゼロ設定 (推奨)

設定は不要です。エージェントが DockerComposeUp を呼び出すと、自動的に次の処理が行われます:

Docker アセットを ~/.zap-mcp/docker/ に展開
ランダムな API キーを生成
localhost:8090 で ZAP コンテナを起動
ZAP が正常になるまで待機

データの永続化

ZAP コンテナは 2 つの Docker 名前付きボリュームを使用します:

ボリューム	コンテナパス	目的
`zap-home`	`/home/zap/.ZAP`	ZAP の設定、コンテキスト、セッション、スキャンポリシー (再起動後も保持)
`zap-data`	`/zap/wrk/data`	レポート、セッションファイル、コンテキストのインポート/エクスポート用の共有ディレクトリ

初回起動時には、テンプレートの config.xml が zap-home にコピーされます。以降の起動では API キーのみが更新され、ZAP を通じて行った変更 (コンテキスト、認証設定、スキャンポリシーなど) は保持されます。

zap-data ボリュームには以下が含まれます:

reports/ — 生成されたスキャンレポート
sessions/ — 保存された ZAP セッション
contexts/ — エクスポートされたコンテキストファイル

Claude Desktop / Claude Code

MCP 設定に追加します:

{
  "mcpServers": {
    "zap": {
      "command": "zap-mcp"
    }
  }
}

VS Code (Copilot)

.vscode/mcp.json に追加します:

{
  "servers": {
    "zap": {
      "command": "zap-mcp"
    }
  }
}

既存の ZAP インスタンスを使用する場合

既に ZAP インスタンスが実行されている場合は、環境変数で接続情報を渡します:

{
  "mcpServers": {
    "zap": {
      "command": "zap-mcp",
      "env": {
        "ZAP_BASE_URL": "http://localhost:8090",
        "ZAP_API_KEY": "your-api-key"
      }
    }
  }
}

利用可能なツール

Docker 管理

ツール	パラメータ	説明
`DockerComposeUp`	—	ZAP コンテナを起動し、正常になるまで待機
`DockerComposeDown`	—	ZAP コンテナを停止して削除
`DockerComposeStatus`	—	コンテナの状態を確認
`DockerComposeLogs`	`tail`	最近のコンテナログを取得

ZAP コア

ツール	パラメータ	説明
`GetVersion`	—	ZAP への接続を確認
`GetHosts`	—	記録されたホストを一覧表示
`GetSites`	—	記録されたサイトを一覧表示
`GetUrls`	`baseUrl`	ベース URL の記録済み URL を一覧表示

スパイダー

ツール	パラメータ	説明
`StartSpider`	`url`、`maxChildren`、`recurse`、`subtreeOnly`、`contextName`	ページをクロールして発見するスパイダースキャンを開始
`GetSpiderStatus`	`scanId`	スパイダーの進行状況を確認 (0〜100%)
`GetSpiderResults`	`scanId`	スパイダーが発見した URL を取得
`StopSpider`	`scanId`	実行中のスパイダースキャンを停止

アクティブスキャン

ツール	パラメータ	説明
`StartActiveScan`	`url`、`recurse`、`inScopeOnly`、`scanPolicyName`、`contextId`	アクティブな脆弱性スキャンを開始
`GetActiveScanStatus`	`scanId`	アクティブスキャンの進行状況を確認 (0〜100%)
`StopActiveScan`	`scanId`	実行中のアクティブスキャンを停止

パッシブスキャン

ツール	パラメータ	説明
`GetPassiveScanStatus`	—	パッシブスキャンの進行状況を確認 (残りレコード数)

アラート

ツール	パラメータ	説明
`GetAlertsSummary`	`baseUrl`	リスクレベル別のアラート数
`GetAlerts`	`baseUrl`、`start`、`count`、`riskId`	ページネーションとリスクフィルター付きの詳細なアラート一覧

レポート

ツール	パラメータ	説明
`GetHtmlReport`	—	HTML スキャンレポートを生成
`GetJsonReport`	—	JSON スキャンレポートを生成
`GetXmlReport`	—	XML スキャンレポートを生成

コンテキスト管理

ツール	パラメータ	説明
`GetContextList`	—	ZAP で定義されたすべてのコンテキストを一覧表示
`GetContext`	`contextName`	コンテキストの詳細を取得 (スコープパターンなど)
`CreateContext`	`contextName`	新しいコンテキストを作成
`RemoveContext`	`contextName`	コンテキストを削除
`IncludeInContext`	`contextName`、`regex`	コンテキストスコープに URL の包含パターンを追加
`ExcludeFromContext`	`contextName`、`regex`	コンテキストスコープに URL の除外パターンを追加
`ImportContext`	`contextFilePath`	コンテキストファイルを ZAP にインポート
`ExportContext`	`contextName`、`contextFilePath`	コンテキストをファイルにエクスポート

認証

ツール	パラメータ	説明
`GetAuthenticationMethod`	`contextId`	コンテキストに設定された認証方法を取得
`SetAuthenticationMethod`	`contextId`、`authMethodName`、`authMethodConfigParams`	認証方法を設定 (フォームベース、JSON ベース、スクリプトベース、HTTP)
`SetLoggedInIndicator`	`contextId`、`loggedInIndicatorRegex`	ログイン状態を示す正規表現パターンを設定
`SetLoggedOutIndicator`	`contextId`、`loggedOutIndicatorRegex`	ログアウト状態を示す正規表現パターンを設定

ユーザー

ツール	パラメータ	説明
`GetUsersList`	`contextId`	コンテキストのすべてのユーザーを一覧表示
`CreateUser`	`contextId`、`name`	新しいユーザーを作成
`RemoveUser`	`contextId`、`userId`	ユーザーを削除
`SetAuthenticationCredentials`	`contextId`、`userId`、`authCredentialsConfigParams`	ユーザー資格情報を設定 (ユーザー名/パスワード)
`SetUserEnabled`	`contextId`、`userId`、`enabled`	ユーザーを有効または無効にする

強制ユーザー

ツール	パラメータ	説明
`SetForcedUser`	`contextId`、`userId`	コンテキストの強制ユーザーを設定
`SetForcedUserModeEnabled`	`enabled`	強制ユーザーモードをグローバルに有効/無効にする
`GetForcedUserStatus`	`contextId`	強制ユーザーモードの状態と現在の強制ユーザーを取得

Ajax スパイダー

ツール	パラメータ	説明
`StartAjaxSpider`	`url`、`inScope`、`contextName`、`subtreeOnly`	JavaScript 多用アプリ用の Ajax スパイダーを開始
`StartAjaxSpiderAsUser`	`contextName`、`userId`、`url`、`subtreeOnly`	特定のユーザーとして Ajax スパイダーを開始
`GetAjaxSpiderStatus`	—	Ajax スパイダーの状態を取得 (実行中/停止)
`GetAjaxSpiderResults`	—	Ajax スパイダーの結果サマリーを取得
`StopAjaxSpider`	—	Ajax スパイダーを停止

一般的なワークフロー

エージェントが DockerComposeUp を呼び出して ZAP を起動
ブラウザ/Playwright を ZAP のプロキシ (http://127.0.0.1:8090) として設定
プロキシ経由で対象アプリケーションを閲覧
エージェントが StartSpider を呼び出してアプリケーションをクロールし、GetSpiderStatus で進行状況を監視
エージェントが GetPassiveScanStatus を呼び出してパッシブスキャンの完了を待機
エージェントが主要ページに対して StartActiveScan を呼び出し、GetActiveScanStatus で進行状況を監視
エージェントが GetAlertsSummary と GetAlerts を呼び出して脆弱性の検出結果を取得
エージェントが GetHtmlReport または GetJsonReport を呼び出してスキャンレポートを生成
完了したらエージェントが DockerComposeDown を呼び出す

注: ZAP の設定 (コンテキスト、認証、スキャンポリシー) は zap-home Docker ボリュームに永続化されます。設定を失うことなくコンテナを停止して再起動できます。

試してみる (同梱の脆弱なアプリを使用)

このリポジトリには、ZAP スキャンを試すための意図的に脆弱な Web アプリケーションが含まれています。このアプリには一般的な脆弱性 (XSS、SQL インジェクション、CSRF、オープンリダイレクト) が含まれており、ZAP が実際の検出結果を見つけられます。

セットアップ

# Start ZAP and the vulnerable target app
docker compose -f tests/docker/docker-compose.test.yml up -d --build

# Wait until both containers are healthy
docker compose -f tests/docker/docker-compose.test.yml ps

次に、MCP クライアントをこの ZAP インスタンスに接続するように設定します:

{
  "mcpServers": {
    "zap": {
      "command": "zap-mcp",
      "env": {
        "ZAP_BASE_URL": "http://localhost:8090",
        "ZAP_API_KEY": "test-api-key-for-ci"
      }
    }
  }
}

脆弱なアプリには、Dockerネットワーク内（ZAPが使用）からは http://target で、ホストマシンからは http://localhost:8080 でアクセスできます。

例1: クイックスキャン

エージェントへのプロンプト:

http://target の脆弱性をスキャンしてください。スパイダークロールを実行し、パッシブスキャンが完了するのを待ってから、アラートの概要を表示し、HTMLレポートを生成してください。

期待されるツールのフロー:

GetVersion          → Verify ZAP connectivity
StartSpider         → url: "http://target"
GetSpiderStatus     → Poll until 100%
GetPassiveScanStatus → Poll until 0 records remaining
GetAlertsSummary    → baseUrl: "http://target"
GetAlerts           → baseUrl: "http://target"
GetHtmlReport       → Generate report

ZAPは /search、/login、/users、/about、/contact などのページを発見し、パッシブスキャンはセキュリティヘッダーの欠落やCSRF脆弱性などの問題を報告します。

例2: 認証付きスキャン

/admin ページにはログインが必要です（ユーザー名: admin、パスワード: password）。認証付きスキャンにより、ZAPは保護されたページにアクセスできます。

エージェントへのプロンプト:

http://target の認証付きスキャンを設定してください。ログインフォームは /login にあり、フィールドは "username" と "password" です（認証情報: admin / password）。ログイン成功の指標は "Welcome, admin" です。認証を設定した後、認証済みユーザーとしてサイトをスパイダーし、アクティブスキャンを実行してください。

期待されるツールのフロー:

CreateContext                   → contextName: "target-auth"
IncludeInContext                → regex: "http://target.*"
SetAuthenticationMethod         → contextId, authMethodName: "formBasedAuthentication",
                                  authMethodConfigParams: "loginUrl=http://target/login&loginRequestData=username%3D%7B%25username%25%7D%26password%3D%7B%25password%25%7D"
SetLoggedInIndicator            → loggedInIndicatorRegex: "Welcome, admin"
CreateUser                      → contextId, name: "admin"
SetAuthenticationCredentials    → contextId, userId, authCredentialsConfigParams: "username=admin&password=password"
SetUserEnabled                  → contextId, userId, enabled: true
SetForcedUser                   → contextId, userId
SetForcedUserModeEnabled        → enabled: true
StartSpider                     → url: "http://target", contextName: "target-auth"
GetSpiderStatus                 → Poll until 100%
GetPassiveScanStatus            → Poll until 0 records remaining
StartActiveScan                 → url: "http://target"
GetActiveScanStatus             → Poll until 100%
GetAlertsSummary                → baseUrl: "http://target"
GetAlerts                       → baseUrl: "http://target"
SetForcedUserModeEnabled        → enabled: false

認証が設定されると、ZAPは /admin にアクセスし、ログインの背後にある脆弱性をテストできます。

例3: 完全な脆弱性評価

エージェントへのプロンプト:

http://target の完全な脆弱性評価を実行してください。サイトをクロールし、アクティブスキャンを実行してから、発見されたすべての脆弱性をリスクレベル別に分類した詳細な内訳を提供してください。

期待されるツールのフロー:

StartSpider          → url: "http://target", recurse: true
GetSpiderStatus      → Poll until 100%
GetSpiderResults     → Review discovered URLs
GetPassiveScanStatus → Poll until 0 records remaining
StartActiveScan      → url: "http://target", recurse: true
GetActiveScanStatus  → Poll until 100%
GetAlertsSummary     → baseUrl: "http://target"
GetAlerts            → baseUrl: "http://target", riskId: "3" (High)
GetAlerts            → baseUrl: "http://target", riskId: "2" (Medium)
GetAlerts            → baseUrl: "http://target", riskId: "1" (Low)
GetHtmlReport        → Generate final report

アクティブスキャンは以下の脆弱性を検出します：

高: SQLインジェクション (/users?id=)、クロスサイトスクリプティング (/search?q=)
中: CSRF（/login のトークン欠落）、オープンリダイレクト (/redirect?url=)
低/情報: セキュリティヘッダーの欠落、Cookieの問題など

クリーンアップ

docker compose -f tests/docker/docker-compose.test.yml down -v

ライセンス

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Related MCP Connectors

Agent-Shield
io.github.startekenterprises-ai
Security scanner for AI agents: prompt injection, leaked secrets, PII, and SSRF-risk URL detection.
Security Penetration Testing
1
https://agent-shield.startekenterprises.com/mcp
AI Agent Security Scanner A
dev.workers.manhliemcn4euwlu.llmrt-companion
Security scanner for AI agents and MCP servers: injection, jailbreak, tool abuse.
Security Penetration Testing Testing & QA Tools
51
https://llmrt-companion.manhliemcn4euwlu.workers.dev/mcp-agent-security
Security Intel MCP A
com.datakoot
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
Penetration Testing Security
51
https://security.datakoot.com/mcp
Security Intel MCP A
io.github.selflabbs
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
Security Penetration Testing
2
https://security.selflabbs.com/mcp

Related MCP Servers

ZAP MCP Server
Penetration Testing Testing & QA Tools Security
LisBerndt
A
license
Not graded
quality
D
maintenance
Integrates OWASP ZAP security testing with AI assistants through MCP, enabling automated vulnerability scanning and AI-powered security analysis during development. Supports multiple scan types including active, passive, and AJAX spider scans with real-time status updates.
Updated 10 months ago (2025-12-22 06:21 UTC)
5
MIT
Grype MCP Serverofficial
Penetration Testing Security
anchore
A
license
A
quality
F
maintenance
Enables AI assistants to perform vulnerability scanning using Grype, supporting scans of directories, container images, and packages via the Model Context Protocol.
Updated a year ago (2025-08-29 00:05 UTC)
9
9
Apache 2.0
ZAP MCP Proxy
Penetration Testing Security
madmystic
F
license
Not graded
quality
D
maintenance
A lightweight MCP server that wraps OWASP ZAP's REST API as Model Context Protocol tools, enabling AI agents to perform automated security scanning.
Updated 4 months ago (2026-07-01 07:59 UTC)
-
Aribot MCPofficial
Penetration Testing Legal & Compliance Security
aristiun
A
license
Not graded
quality
D
maintenance
Enables security work such as threat modeling, scanning, compliance checks, and remediation through AI assistants using the Model Context Protocol.
Updated 4 months ago (2026-07-13 13:22 UTC)
MIT

dotnet-zap-mcp

特徴

インストール

前提条件

設定

ゼロ設定 (推奨)

データの永続化

Claude Desktop / Claude Code

VS Code (Copilot)

既存の ZAP インスタンスを使用する場合

利用可能なツール

Docker 管理

ZAP コア

スパイダー

アクティブスキャン

パッシブスキャン

アラート

レポート

コンテキスト管理

認証

ユーザー

強制ユーザー

Ajax スパイダー

一般的なワークフロー

試してみる (同梱の脆弱なアプリを使用)

セットアップ

例1: クイックスキャン

例2: 認証付きスキャン

例3: 完全な脆弱性評価

クリーンアップ

ライセンス

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

ZAP MCP Server

Grype MCP Serverofficial

ZAP MCP Proxy

Aribot MCPofficial