cybersec-toolkit

    /\   /\        ______      __              _____
   (o ) ( o)      / ____/_  __/ /_  ___  _____/ ___/___  _____
    \ \_/ /      / /   / / / / __ \/ _ \/ ___/\__ \/ _ \/ ___/
  <==\   /==>   / /___/ /_/ / /_/ /  __/ /   ___/ /  __/ /__
     \ V /      \____/\__, /_.___/\___/_/   /____/\___/\___/
     /_ _\           /____/                          by 26zl
      |_|                     Toolkit

AI エージェントが、設定したルールに従って操作できるセキュリティツールキットです。 1 つのコマンドで、Linux または Termux に 670 以上のセキュリティツールをインストールできます。MCP（Model Context Protocol） サーバーにより、Claude Code、Codex、Gemini CLI、OpenCode などの MCP クライアントがツールを検出、推奨し、デフォルトでは使い捨ての Kata Containers VM 内で、管理された実行経路を通じて実行できます。872 のエージェントスキルが、CTF、ペネトレーションテスト、バグバウンティ、DFIR、ブルーチームの作業方法を提供します。

他との違い： ほとんどのツールキットは、ツールの インストール までで終わります。このツールキットでは、AI がツールを 操作 することもできます。問題の種類を推測し、すべてのモジュールとプロファイルからツールを選び、手順を追って一緒に問題に取り組みます。明示的に許可すると、同じツールチェーンで自律型のソルバーループを実行できます。デフォルトでは伴走型。自律動作は依頼された場合のみ。 Kali、Parrot、BlackArch を置き換えるのではなく、補完するものです。Termux を含む、すでにお使いのマシン上で動作します。

クイックスタート · 仕組み · 信頼と安全性 · インストーラー · MCP サーバー · エージェントスキル · 開発 · ライセンス

クイックスタート

1. ツールをインストールします。サポートされている Linux ディストリビューションまたは Termux にインストールします。

git clone --depth 1 --branch v1.4.0 https://github.com/26zl/cybersec-toolkit.git && cd cybersec-toolkit
./install.sh --doctor             # read-only preflight: distro, prerequisites, MCP server, sandbox
sudo ./install.sh --profile ctf   # one profile; with no flags, all 18 modules

2. AI クライアントを接続します。 Claude Code（GitHub Copilot CLI からも読み込まれる .mcp.json）、Codex、Gemini CLI、OpenCode 用の追跡対象設定では、外部ターゲットとスクリプトの実行を無効にした状態で、scripts/mcp-launch.sh を使ってサーバーを起動します。ツールの実行場所を選択してください。

Kata には KVM が必要です。macOS、Windows、およびネストされた仮想化に対応していない VM では、ホストモードを使用してください。

3. クライアントを再起動します。 15 個のツールが表示されます（Claude Code では /mcp）。次に、「このバイナリをトリアージして」や「10.10.0.0/24 にあるラボの攻撃対象領域をマッピングして」のように、必要なことを依頼してください。

仕組み

2 つのエントリーポイントが、1 つのツールレジストリを共有します。__オペレーター__は bash インストーラーを実行して、ホスト上またはビルド時にサンドボックスイメージ内へツールを配置します。__AI エージェント__は MCP サーバーと通信します。デフォルトでは Kata VM 内で実行されるこのサーバーを通じて、単一の管理された経路からツールを検出、推奨、実行します。tools_config.json は、モジュールが定義し、MCP アドバイザーが読み取る唯一の信頼できる情報源です。CI バリデーターは Python 側と bash 側の整合性を保ちます。

実線の矢印は実行時またはインストール時のアクションを示し、破線の矢印は検証とコンテキストの関係を示します。クライアント設定はルート認識型ランチャーを介して渡されます。ランチャーは Sandcastle Kata プロバイダー（sandbox/kata.mjs）を通じて VM を起動します。--local を指定した場合は、ホスト上でサーバーを起動します。security.py は、シェルを呼び出すことなく、許可リスト、引数チェック、ネットワークポリシーを通じて run_tool と run_pipeline を管理します。run_script はデフォルトで無効になっている別の機能で、任意のコードを実行します。Agent Skills は実行経路の外部にあります。.claude/skills/ が正規の場所で、scripts/sync-skills.sh は、ポータブルなミラーを読み込むクライアント向けに .agents/skills/ を生成します。Mermaid のソース：assets/how-it-works.mmd。

信頼と安全性

実行されるものと、制限されるもの：

• デフォルトで安全な MCP. CYBERSEC_MCP_ALLOW_EXTERNAL=0 は、プライベートまたはループバックの範囲に解決されないネットワークターゲットを拒否し、CYBERSEC_MCP_ALLOW_SCRIPTS=0 は run_script を無効にします。外部スコープとスクリプトの実行は明示的なオプトインです。
• 管理された実行のための単一のゲート（mcp_server/security.py）：レジストリの許可リスト、シェル不使用（create_subprocess_exec を使用し、shell=True は使用しません）、引数のサニタイズ、ツールごとのブロック対象フラグの拒否リスト（例：sqlmap --os-shell、nmap -iL、ファイル一覧・ターゲットへのインジェクションに使えるフラグ）、ターゲットとネットワークのポリシー、レート制限、出力上限、タイムアウトを適用します。このポリシーは、ターゲットとヘッダー、ワードリスト、出力先パス、ターゲット一覧フラグを区別できるだけの CLI 構文を把握しています。ツールの出力からターミナルエスケープシーケンスと LLM 制御マーカーを除去してからモデルに渡し、AI の読み手に向けられた行にはフラグを付けます。
• ツールはデフォルトで使い捨て VM 内で実行されます。 起動ツールは、独自のカーネルを備え、オプションの CYBERSEC_SANDBOX_WORKSPACE マウントを除いてホストのファイルシステムにアクセスできず、Docker ソケットもなく、すべてのケイパビリティを削除した非 root ユーザーを使い、メモリ、CPU、プロセスに制限を設けた Kata Containers VM を起動します。クライアントが切断されると破棄されます。起動に失敗した場合はホスト上での実行にフォールバックせず、フェイルクローズします。--local は明示的なオプトアウトです。
• 制限を把握してください。 VM はネットワーク境界ではありません。Docker ネットワークが接続できる先には VM からも接続でき、CYBERSEC_MCP_ALLOW_EXTERNAL は解決済みアドレスに対する事前チェックであってファイアウォールではありません（CYBERSEC_SANDBOX_NETWORK=none を設定するか、フィルタリングされたネットワークを使用してください）。VM 内でも、--local モードのホスト上でも、許可されたツールはサーバーユーザーの権限で実行され、一部のツールは子プロセスを起動したり、プラグインを読み込んだりします。
• ツールの出力はモデルプロバイダーに送信されます。 ツールが出力する内容はすべて、スキャン結果、ページの内容、ターゲット上で見つかった認証情報や個人データも含め、AI クライアントに返され、クライアントが使用するモデルに送信されます。デフォルトではローカルの監査ログのみが秘匿化されます。クライアントが受け取る内容からも認証情報らしき文字列を秘匿化するには、CYBERSEC_MCP_REDACT_OUTPUT=1 を設定してください。エンゲージメントの規則でクライアントのデータを第三者と共有することが禁止されている場合は、ローカルモデルからサーバーを操作してください（AI クライアントを参照）。
• リポジトリのフックは自動実行されます。 このリポジトリを Claude Code で開くと、追跡対象の .claude/settings.json 内のフックが実行されます。セッション開始時と各 Bash コマンドの実行前に scripts/agent-guard.sh が実行されます。フックはルーティングコンテキストまたは拒否の判定のみを出力し、ネットワーク通信は行わず、フェイルオープンで動作します。無効にするには CYBERSEC_AGENT_GUARD=0 を設定してください。
• 漏えいのない監査証跡。 操作は、ユーザーの状態ディレクトリ内にある所有者のみ読み書き可能（0600）なローテーション形式のログ（デフォルトでは ~/.local/state/cybersec-tools-mcp/audit.log）に JSON 行として記録されます。スクリプト本体は保存されず、SHA256 と長さのみが保存されます。また、ツールの引数から認証情報らしき文字列が秘匿化されます。サンドボックス内のサーバーは記録を同じホストログにも複製し、記録をハッシュチェーンで連結するため、チェーン内で編集または削除された記録は make audit-verify で検出できます（制限事項）。
• インストーラーでは最小権限を適用します。 root として実行されますが、クローンしたリポジトリのビルド、go／cargo／gem のビルド、およびプロジェクトのセットアップ手順（theHarvester、pwndbg）では、実行ユーザー（$SUDO_USER）に権限を落とします。バイナリのリリースは、チェックサムが公開されている場合、SHA256 で検証されます。pipx によるインストール（共有の /opt/pipx へのインストール）とグローバルな npm のインストールは引き続き root として実行されるため、ビルドスクリプトとインストールスクリプトは root 権限で実行されます。サプライチェーンモデルを参照してください。Go バイナリは root 所有のファイルとして /usr/local/bin にコピーされます。cargo、gem、クローンしたリポジトリ、ソースからのビルド、patator、Foundry の各ツールは、実行ユーザーが所有するツリーへのリンクまたはラッパーとしてそこに配置されるため、そのユーザーはそれらのコマンドが実行する内容を変更できます。
• デュアルユースのツールにはゲートを設けています。 C2 とフィッシングのフレームワーク（Sliver、Caldera、gophish、evilginx、…）はデフォルトで 無効 であり、--include-c2 を指定した場合のみインストールされます（redteam と full プロファイルではこのオプションが設定されます）。MCP レイヤーにもこれが反映され、ツールが自動実行されることはありません。
• 使用は許可された範囲に限ります。 SECURITY.md、サプライチェーンモデル、免責事項を参照してください。

インストーラー

要件

サポート対象の Linux ディストリビューション（Debian/Ubuntu/Kali/Parrot、Fedora/RHEL、Arch、openSUSE）または Termux が必要です。ランタイム（Python、Go、Ruby、Java、Rust、Node.js）、開発ライブラリ、pipx、ビルドツールは自動的にインストールされます。インストーラーは macOS またはネイティブの Windows では動作しません。WSL または Docker を使用してください。

• Docker は --enable-docker（C2 フレームワーク、MobSF、BeEF、BloodHound、TheHive、Cortex）と、Docker イメージがデフォルトで有効になる blueteam、redteam、blockchain、mobile プロファイルに必要です（プロファイルを参照）。Docker はご自身でインストールしてください：Docker Engine のドキュメント。
• __GitHub 認証__を推奨します。インストーラーは約50個のリリースバイナリをダウンロードし、GitHub API を約50回以上呼び出します。未認証のリクエストは1時間あたり60回まで、認証済みのリクエストは5,000回までです。gh auth login のセッションを、sudo 実行時も含めて自動的に使用します。または、個人用アクセストークン（スコープは不要）を sudo 経由で渡してください。通常、sudo はトークンを引き継がないため、次のようにします：sudo --preserve-env=GITHUB_TOKEN ./install.sh。

インストール

最新リリースから（バージョン固定、推奨）：

git clone --depth 1 --branch v1.4.0 https://github.com/26zl/cybersec-toolkit.git && cd cybersec-toolkit && sudo ./install.sh

main から（未リリースの作業を含む、最新のツールと修正）：

git clone https://github.com/26zl/cybersec-toolkit.git && cd cybersec-toolkit && sudo ./install.sh

フラグを指定しない場合、インストーラーは全18モジュールの標準ツールを対象にします。プロファイルで有効にしない限り、C2／フィッシングツールと Docker イメージはオプトインのままです（プロファイルの Docker 列と C2 列を参照）。--profile full --enable-docker を指定すると、現在のプラットフォームでサポートされているすべての項目がインストールされます。一部のみをインストールするには：

sudo ./install.sh --profile ctf                      # CTF tools only
sudo ./install.sh --profile redteam --enable-docker  # Red team + Docker C2
sudo ./install.sh --module web --module recon        # Specific modules
sudo ./install.sh --tool sqlmap --tool nmap          # Individual tools
./install.sh --dry-run --profile ctf                 # Preview without installing; no root needed
./install.sh --doctor                                # Read-only preflight; no root needed

./install.sh --help                     # Full help
./install.sh --list-profiles            # Show profiles
./install.sh --list-modules             # Show modules
sudo ./install.sh --skip-heavy          # Skip large/slow packages
sudo ./install.sh --skip-pipx           # Skip all pipx (Python) installs
sudo ./install.sh --skip-go             # Skip all Go tool installs
sudo ./install.sh --skip-cargo          # Skip all Cargo (Rust) installs
sudo ./install.sh --skip-gems           # Skip all Ruby gem installs
sudo ./install.sh --skip-git            # Skip all git clone installs
sudo ./install.sh --skip-binary         # Skip all binary release downloads
sudo ./install.sh --skip-source         # Skip build-from-source, snap, npm, and curl-pipe installs
sudo ./install.sh --fast                # Skip checksum verification (see Supply chain model)
sudo ./install.sh --require-checksums   # Fail if a binary release has no checksum file
sudo ./install.sh --production          # Strict checksum preset for release downloads
sudo ./install.sh --upgrade-system      # Upgrade system packages before installing
./install.sh --list-sessions            # List install sessions and exit
sudo ./install.sh --rollback <id|last>  # Roll back a session's tools (add --yes when not on a terminal)
./install.sh --version                  # Show installer version and exit
sudo ./install.sh --enable-docker       # Pull Docker images
sudo ./install.sh --include-c2          # Include C2/phishing frameworks (Empire also needs --enable-docker)
sudo ./install.sh -j 8                  # 8 parallel install jobs (default: 4)
sudo ./install.sh -v                    # Verbose / debug output

ビルド済みイメージは Ubuntu 上のインストーラーであり、サンドボックスではありません。デフォルトのコマンドは、full プロファイルのドライランです。

docker run --rm ghcr.io/26zl/cybersec-toolkit                                  # preview only
docker run -it --name cybersec --entrypoint bash ghcr.io/26zl/cybersec-toolkit  # keep a container
sudo ./install.sh --profile ctf                                                # inside it; reattach with: docker start -ai cybersec

docker build -t cybersec-toolkit . で自分でビルドするか、同梱の Compose ファイルを使って docker compose run --rm installer --profile ctf で一時的なインストールを実行してください。Apple シリコンでは、docker build と docker run に --platform linux/amd64 を追加してください。Podman はそのまま置き換えて使用できます（podman compose には Compose プロバイダーが必要です）。イメージでは toolkit ユーザーにパスワードなしの sudo 権限を付与しているため、パッケージを管理できます。イメージ内のコードは root 権限を持つものとして扱ってください。

Termux（Android）

pkg install git
git clone https://github.com/26zl/cybersec-toolkit.git && cd cybersec-toolkit
./install.sh --profile lightweight

プロファイル

Docker と C2 は、各プロファイルでデフォルトで有効になる機能を示しています。Docker を有効にするプロファイルは、Docker がインストールされていない場合、エラーで停止します。先に Docker をインストールするか、プロファイルの代わりに --module を使って同じモジュールを選択してください。

モジュール

すべてのスクリプトは --help と --version に対応しています。Linux では、update.sh と remove.sh の実行には root 権限（sudo）が必要です。また、backup.sh schedule と unschedule の実行にも root 権限が必要です。verify.sh とその他の backup.sh コマンドは、ユーザー権限で実行します。Termux では root 権限は不要です。ターミナルを使わずに実行する場合は、remove.sh（および install.sh --rollback）に --yes を渡してください。

完全に削除した後、--deep-clean を実行すると、Go モジュール／ビルドキャッシュ、Cargo レジストリ、pip／pipx／npm／gem キャッシュ、孤立した pipx 仮想環境、古いシンボリックリンク、ログファイルが削除されます。Rustup のツールチェーンも消去するには、--remove-deps を追加してください。

__主な対象はDebian/Ubuntu/Kali__で、最も幅広くテストされています。KaliとParrotではaptパッケージ一式を利用できますが、通常のDebian/UbuntuではKali専用パッケージの一部がスキップされます。Fedora、Arch、openSUSEでは、各ディストリビューションのリポジトリにないパッケージ（lib/distro_compat.tsvの-の項目。各ディストリビューションにつき数十件）がスキップされ、統合ワークフローで実行されます。

インストーラーによる変更

パッケージのインストール以外にも、インストールによってシステムに変更が加えられることがあります。これらの変更はremove.shでは元に戻りません。

• aptのソース: Metasploitリポジトリ（/etc/apt/sources.list.d/metasploit-framework.list。キーは/usr/share/keyrings/metasploit-framework.gpg）は、このツールキットがインストールしたMetasploitを削除する際にremove.shによって削除されます。また、NodeSourceのセットアップスクリプトによってNodeSourceリポジトリとキーが追加され、これらは残ります。削除後もaptはNodeSourceを信頼し続けるため、不要になった場合はソースを手動で削除してください。
• Arch: /etc/pacman.confでParallelDownloadsが有効になります。
• aptベースのディストリビューションのsnapd: snap専用ツールのためにインストールされます。
• ランタイム: Go SDKは/usr/local/goに、rustup、cargo、uvは実行ユーザーのホームディレクトリにインストールされます。
• /opt、/opt/pipx、/usr/local/bin内の__ツール__。

このツールキットがこのマシンにのみ保存するデータ：

• チェックアウト内の.versions、.install_sessions/、*.log：インストールの来歴とログ。
• ~/.local/state/cybersec-tools-mcp/：MCP監査ログとそのローテーションファイル、remote_hosts.json、およびエージェントガードのguard-session*マーカーとguard-denials.log。
• ~/cybersec_tools_backup/：暗号化された設定バックアップ。
• チェックアウト内のwriteups/（gitで無視されます）。

remove.sh --deep-cleanはキャッシュとチェックアウト内のログを削除しますが、MCPの状態ディレクトリ、バックアップ、writeupsは削除しません。不要になった場合は、これらを手動で削除してください。

サプライチェーンモデル

インストーラーはインターネットからコードをダウンロードして実行します。Linux では root（sudo）として実行され、Termux ではアプリのユーザーサンドボックス内で実行されます。

• システムパッケージ：ディストリビューションのリポジトリ（apt、dnf、pacman、zypper、pkg）によって署名されています。openSUSE では、CI=true または CYBERSEC_ZYPPER_AUTO_IMPORT_KEYS=1 が設定されている場合に限り、zypper refresh は新しいリポジトリキーやローテーションされたリポジトリキーを自動的に信頼します。
• pipx/Go/Cargo/Gem/npm：署名検証なしで各レジストリから取得されます。pipx のツールは venv 内で分離されます。Go、Cargo、Gem のビルドは実行ユーザーとして実行されます。pipx とグローバル npm のインストールは root として実行されるため、パッケージのビルドバックエンドと npm のライフサイクルスクリプトは root 権限で実行されます。
• バイナリリリース：上流のチェックサムファイル、GitHub リリースの正確なアセットダイジェスト、または lib/release_checksums.tsv 内のレビュー済みリポジトリ／タグ／アセットのチェックサムを使用して SHA256 検証されます。不一致があれば必ず失敗します。--require-checksums または --production を指定した場合、検証データが利用できないときも失敗します。これらのチェックで確認できるのはダウンロードの完全性であり、独立した配布元の認証ではありません。--fast は通常のリリース検証を省略し、厳格なフラグと併用できません。プライベートなランタイム依存関係は常に検証が必要です。
• ランタイムのブートストラップ：rustup、uv、cargo-binstall のインストーラーと NodeSource のセットアップスクリプト（root として実行）は HTTPS 経由で取得され、実行前に健全性がチェックされますが、署名検証は行われません。厳格モード（--production／--require-checksums）では、rustup、uv、cargo-binstall のインストーラーが root として実行される場合（つまり、通常ユーザーから sudo なしで実行される場合）はスキップされます。また、NodeSource のスクリプトは常にスキップされ、ディストリビューションの署名済み nodejs／npm が優先されます。その後、cargo-binstall は利用可能な場合、ビルド済みの Rust バイナリをダウンロードします。新しいホストで --skip-source を指定すると、そのインストーラーはスキップされるため、Rust ツールは crates.io からコンパイルされます。
• Go SDK：API に接続できる場合は go.dev を参照して SHA256 検証されます。厳格モードでは、接続できない場合に失敗します。
• Git リポジトリ：HEAD の状態でクローンされます。リポジトリ独自の setup.py は実行されません。requirements.txt は実行ユーザーとしてリポジトリごとの venv にインストールされます。このとき依存関係の sdist がビルドされる場合があります。また、厳格モード（--production または --require-checksums）以外では、ピン留めされたインストールが失敗すると、== を >= に緩和して再試行します。
• ソースからのビルド：make は root ではなく実行ユーザーとして実行されます。ビルドする内容を確認してください。
• MCP の Python 依存関係：uv によって 3 日間の exclude-newer ウィンドウを設定して解決され、Dependabot も同じ 3 日間待機します。これはセキュリティツール自体には適用されず、セキュリティツールはそれぞれの上流リリースチャネルに従います。
• Toolkit の Docker イメージ：Ubuntu と uv はダイジェストで固定されています。apt パッケージは現在の署名済み Ubuntu リポジトリから解決されるため、再ビルドしてもビット単位で同一にはなりません。
• オプションのツールイメージ：変更可能なタグで取得され、そのうち複数は latest です。--production では固定も検証も行われません。

--production では、Git のクローン、言語パッケージのレジストリ、ソースからビルドするツールは固定されません。これらはそれぞれの上流リリースチャネルに従います。

Windows Defender の誤検知

Windows からマウントされたパス（例：C:\Users\<you>\...、または WSL で作業中に Windows から参照できるフォルダー）では、Microsoft Defender やその他のウイルス対策製品によって個々のファイルが隔離されることがあります。.claude/skills/、writeups/、および mcp_server/ の一部にある IOC テーブル、難読化された PowerShell のサンプル、マルウェア分析のスニペット、エクスプロイト文字列には、実際の攻撃者が使用するものと同じバイトパターンが含まれています。よくある判定には、Trojan:Script/Wacatac.B!ml、HackTool:*、一般的な Heur.* などがあります。これらはセキュリティツールキットに対する誤検知です。

MCP サーバー

このサーバーは、MCP 対応クライアントに対して、670 以上のツールレジストリ、インストール状況、推奨事項への読み取りアクセスと、インストール済みツールの管理された実行を提供します。エージェントはすべてのツールと、利用可能なツール、およびツールの連携方法を把握できます。

対応クライアント

Claude Code、Codex、Gemini CLI、OpenCode、GitHub Copilot CLI は、追跡対象の設定を自動的に読み込みます。Claude Desktop、VS Code の Copilot、Hermes Agent、OpenClaw、DeepSeek Harness、Cursor、Cline、Goose、Continue、LM Studio は、それぞれ独自の MCP 設定を介して接続します。Ollama や Open WebUI は、MCP ホストまたはブリッジを介して接続します。クライアントごとのスキル検出状況とテスト状況を含む対応状況の一覧は、docs/AI_CLIENTS.md にあります。

任意の MCP クライアント間で複数のエージェントを連携させる方法については、docs/ORCHESTRATION.md をご覧ください。

このサーバーは io.github.26zl/cybersec-toolkit として公式 MCP Registry に公開されており、Glama にも掲載されています。

AI にできること

• 「この RSA を解読してください — 小さな e、複数の暗号文」 — 攻撃（Håstad／共通法／Wiener）を検出し、venv 内の pycryptodome と sympy を使って解読し、平文を返します
• 「この JWT は HS256 で、鍵が弱いです」 — 署名シークレットをクラックし、管理者トークンを偽造します

ブルーチーム・検知エンジニアリング

• 「この手法の Sigma ルールを書いて、使用している SIEM 向けに変換してください」 — ルールを作成し、sigma-cli を使って対象のバックエンド（Splunk／Elastic）向けに出力します
• 「この Windows イベントログを調べて、横展開を探してください」 — Sigma ルールを使って EVTX を chainsaw で解析し、検出結果をホストとタイムラインごとに要約します
• 「これらのサンプルから YARA ルールを作成し、ディレクトリツリーをスキャンしてください」 — yara シグネチャを生成し、再帰的に実行します

DFIR・マルウェアのトリアージ

• 「このメモリダンプのタイムラインを作成してください」 — volatility3 のプラグイン（pslist、netscan、malfind）をまとめて実行し、結果をひとつの説明にまとめます
• 「この pcap から C2 のビーコン通信を探してください」 — tshark／tcpdump で抽出 → suricata ルール → 周期的なコールバックにフラグを付けます
• 「この不審なファイルを静的解析でトリアージしてください」 — file → strings → capa／yara の順に実行し、IOC を抽出して情報を補完します

クラウド・コンテナ・運用

• 「この AWS アカウントの公開 S3 とリスクの高い IAM を監査してください」 — prowler／scoutsuite を実行し、重大度の高い検出結果のみを表示します
• 「デプロイ前にこのイメージと k8s マニフェストをスキャンしてください」 — イメージを grype でスキャンし、kubescape で設定をチェックします
• 「レッドチームの対応範囲を確認して、不足を補ってください」 — get_profile_tools("redteam") の結果とインストール状況を比較し、正確なインストールコマンドを出力します

モバイル・ワイヤレス・ブロックチェーン

• 「この APK を静的解析し、シークレットと安全でないストレージを探してください」 — apktool／jadx で逆コンパイル → MobSF 形式のチェックを行い、鍵とエンドポイントを grep で検索します
• 「この Wi-Fi キャプチャを監査してください」 — ハンドシェイクを解析し、aircrack-ng／hashcat で解析します
• 「この Solidity コントラクトにリエントランシーの問題がないか確認してください」 — slither／mythril を実行し、検出結果を説明します

run_tool と run_pipeline は引数がサニタイズされ、ネットワークが制御され、レート制限が適用され、監査ログが記録されます。また、破壊的なフラグ（--os-shell、-rf、--exploit、…）はブロックされます。run_script はデフォルトで無効です。有効にすると、サーバーのユーザーが持つファイルシステムとネットワークの権限で任意のコードが実行されます（デフォルトでは VM 内、--local を指定するとホスト上）。外部ターゲットに関するポリシーは適用されません。テストの許可を得ているシステムに対してのみ使用してください。

scripts/mcp-launch.sh は、--local を渡すか CYBERSEC_SANDBOX_MODE=local を設定しない限り、Kata Containers VM 内でサーバーを起動します。VM は、Kata ランタイムを固定する Sandcastle の隔離サンドボックスプロバイダー（sandbox/kata.mjs）によって作成されます。同じプロバイダーを、MCP クライアントの代わりに Sandcastle のエージェントオーケストレーションループの基盤として使用することもできます。起動時は安全側に失敗します。ランタイム、サンドボックスイメージ、KVM デバイス、Node.js、またはランチャーの依存関係が不足している場合、ホストにフォールバックせず、その理由を示してサーバーを停止します。./install.sh --doctor でサンドボックスの準備状況を確認できます。セットアップ、調整、脅威モデルについては、docs/SANDBOX.md を参照してください。

• VM には独自のツールセットがあります。 サンドボックスイメージには、MCP サーバーのほか、file、git、binutils、nmap、curl、Python が含まれています。ホストにインストールされたツールは VM 内からは見えず、check_installed とアドバイザーが報告するのはゲストのツールです。代わりにイメージにプロファイルを組み込み、サーバーの変更を取得した後に再ビルドしてください。イメージにはサーバーのコピーが含まれているためです。

  make sandbox-image TOOLKIT_PROFILE=ctf
  

• ファイル： CYBERSEC_SANDBOX_WORKSPACE に絶対パスを指定しない限り、VM からホストのパスは見えません。指定したディレクトリは /workspace として表示されます（CYBERSEC_SANDBOX_WORKSPACE_RO=1 の場合は読み取り専用です）。run_tool にはゲストのパスを渡してください。

• ネットワーク： VM は Docker のデフォルトブリッジを使用します。オフライン分析には CYBERSEC_SANDBOX_NETWORK=none を設定するか、フィルタリングされた Docker ネットワークを使用して送信トラフィックを制限してください。

• 権限： デフォルトでは uid 10001、すべてのケイパビリティを削除、no-new-privileges を設定し、2 GB／2 vCPU／512 プロセスに制限されています。サンドボックスでは Raw ソケットスキャン（nmap -sS、-sU、OS 検出）は使用できません。ゲストユーザーに権限がなく、no-new-privileges が設定されているため、NET_RAW ケイパビリティを追加しても有効になりません。コネクトスキャン（-sT）または --local モードを使用してください。

• ホストモードのみ： SSH 経由のリモート実行（manage_remote_hosts）と、ホスト上で作成した ~/.ctf-venvs/ 配下の venv。

• 監査： 記録は stderr のサイドチャネル経由で VM の外に送られ、ホストのログに追記されるため、VM が終了した後も記録が残ります。

クライアントの設定

Claude Code は追跡対象の .mcp.json を読み込みます。

{
  "mcpServers": {
    "cybersec-tools": {
      "command": "bash",
      "args": [
        "-lc",
        "cd \"$(git rev-parse --show-toplevel)\" && exec bash scripts/mcp-launch.sh"
      ],
      "env": {
        "CYBERSEC_MCP_ALLOW_EXTERNAL": "0",
        "CYBERSEC_MCP_ALLOW_SCRIPTS": "0"
      }
    }
  }
}

ログインシェル（bash -lc）はプロファイルから node と uv を読み込むため、プロファイルのスクリプトが標準出力に出力しないようにしてください。標準出力には MCP プロトコルが流れます。ほかのクライアントでも同じランチャーを使います。どのディレクトリからでも実行できます。

bash /path/to/cybersec-toolkit/scripts/mcp-launch.sh           # Kata VM (default)
bash /path/to/cybersec-toolkit/scripts/mcp-launch.sh --local   # host, no VM boundary

• Codex: プロジェクトの .codex/config.toml は最初に Git ルートを解決するため、どのサブディレクトリからでも動作します。Codex がプロジェクト設定を無視する場合は、[mcp_servers.cybersec-tools] ブロックを ~/.codex/config.toml にコピーしてください。
• Cursor / Continue / Cline / Goose: クライアントの MCP 設定に起動コマンドを追加します。クライアントの作業ディレクトリがリポジトリのルートでない場合は、絶対パスを指定してください。
• LM Studio (≥0.3.17): MCP ホストそのものです。絶対パスを指定して、サーバーを mcp.json に追加します（.mcp.json と同じ mcpServers の形式です）。LM Studio の API 経由の MCP には、≥0.4.0 と /api/v1/chat や /v1/responses などの MCP 対応エンドポイントが必要です。
• Ollama およびその他のローカルモデル: モデルのランタイムは MCP を話しません。MCP 対応ホスト（OpenCode、Hermes、OpenClaw、Kit、LM Studio、Cline、Continue、Goose、または mcpo などの MCP→OpenAPI ブリッジを介した Open WebUI）を手前に配置し、そのホストからランチャーを指定してください。

まずはこのサーバーだけを起動し、許可されたスコープがない限り、スクリプトと外部ターゲットは無効のままにしてください。人間がツールの使用を承認するホストを優先してください。ベンダーに依存しないリポジトリの手順は AGENTS.md にあります。Claude Code は CLAUDE.md を、Gemini CLI は GEMINI.md を読み込みます。

{
  "mcpServers": {
    "cybersec-tools": {
      "command": "wsl",
      "args": [
        "-d", "kali-linux",
        "bash", "-lc",
        "cd ~/cybersec-toolkit/mcp_server && uv run fastmcp run server.py --transport stdio --no-banner"
      ]
    }
  }
}

{
  "mcpServers": {
    "cybersec-tools": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "CYBERSEC_MCP_ALLOW_EXTERNAL=0", "-e", "CYBERSEC_MCP_ALLOW_SCRIPTS=0",
        "--entrypoint", "bash", "cybersec-toolkit",
        "-c",
        "cd /opt/cybersec-toolkit/mcp_server && uv run fastmcp run server.py --transport stdio --no-banner"
      ]
    }
  }
}

スクリプトの実行

run_script を使うと、エージェントが Python または Bash を記述して実行できます。クライアントの env ブロックに "CYBERSEC_MCP_ALLOW_SCRIPTS": "1" を設定して有効にします。スクリプトにはサーバープロセスのファイルシステムとネットワークの権限が適用されます（デフォルトでは VM、--local モードではユーザーの権限）。また、CYBERSEC_MCP_ALLOW_EXTERNAL による制限も適用されません。有効にする前に、生成されたコードとスコープを確認してください。

コンソールスクリプトを持たない Python ライブラリは、~/.ctf-venvs/ の名前付き venv に格納されます（CYBERSEC_MCP_VENVS_DIR で変更できます）。スクリプトごとに venv パラメーターで選択します。./install.sh --module crypto を実行すると、pycryptodome、sympy、gmpy2、numpy、z3、fpylll（インポート時に必要ですが依存関係として宣言されていない cysignals を含む）、および cypari2 を含む ~/.ctf-venvs/crypto が作成され、エージェントは run_script(code, venv="crypto") を呼び出せるようになります。サンドボックス内では、venv はゲスト側のパスです。crypto を利用するには、TOOLKIT_PROFILE=ctf を指定してイメージをビルドしてください。pwntools など、一部のパッケージには古い Python が必要です。

python3.12 -m venv ~/.ctf-venvs/pwntools
~/.ctf-venvs/pwntools/bin/pip install pwntools z3-solver

名前付き venv がない場合、スクリプトからは FastMCP と標準ライブラリを利用できます。cd mcp_server && uv sync --extra ctf-core を実行すると、requests、pycryptodome、beautifulsoup4、Pillow、NumPy が追加されます。

エージェントが作成した、再利用可能なヘルパー（エクスプロイト、複数ステップのソルバー、パーサー、プロトコルヘルパーなど）は、manual_scripts/ に保存されます。コンパニオンモードでは、エージェントがスクリプトを提案し、承認を得てから実行します。autonomous モードでは、ツールやパイプラインで進展がなくなった場合、エージェントはスコープを限定したヘルパーを作成して実行します。通常の偵察や HTTP リクエストには、run_tool を使います。

サーバーをテストする

cd mcp_server && uv run fastmcp dev inspector server.py

各ツールをインタラクティブに試せる MCP Inspector が開きます。Claude Desktop のセットアップとサーバーの完全なリファレンスについては、mcp_server/README.md をご覧ください。

エージェントスキル

872 個のエージェントスキルが .claude/skills/ にあり、Claude Code が直接検出する正規のツリーです。スキルはコンテキストを常に占有するのではなく、その時点のタスクに応じて必要になったときに読み込まれます。31 個はプロジェクトで作成され、841 個はオープンソースプロジェクトから厳選したもので、それぞれ THIRD_PARTY_NOTICES.md にクレジットを記載しています。

• プロジェクト開発者向けスキル 10 個（add-tool、validate-all、module-scaffold、writeup-template、mcp-sync-check、security-wordlists、security-payloads、guided-assessment、skill-dependency-audit、skill-curation-router）
• 検出事項、コミュニケーション、認可チェック、証拠のサニタイズを振り分ける、スキル間コーディネーター 4 個（finding-triage、security-comms、authorization-gate、evidence-hygiene）
• カバレッジのギャップを補うアンカー 7 個（GRC／プライバシー、AI／LLM セキュリティ、IoT／組み込み／ハードウェア、メインフレーム、通信／5G、SAP／ERP、サプライチェーン／製品セキュリティ）
• CTF 手法スキル 6 個（ctf-crypto、ctf-pwn、ctf-web、ctf-rev、ctf-forensics、ctf-stego）と、バグバウンティ手法スキル 4 個（bounty-recon、bounty-web、bounty-api、bounty-mobile）
• mukul975/Anthropic-Cybersecurity-Skills の運用向けハウツー 754 個（Apache 2.0）
• SnailSploit Claude-Red の攻撃手法スキル 58 個（MIT）
• Trail of Bits のコード監査スキル 14 個（CC-BY-SA 4.0）
• BugHunter (claude-bug-bounty) のバグバウンティワークフロースキル 10 個（MIT）
• Transilience の高レベルワークフロー 4 個（MIT）
• multica-ai/andrej-karpathy-skills のコーディングエージェント向けワークフロースキル 1 個（MIT）

ソースとカテゴリのインデックス：.claude/skills/SKILLS.md。ランキングとキュレーションについては、.claude/skills/CURATION.md と curation.json をご覧ください。python3 scripts/curate_claude_skills.py --write で再生成できます。

Claude Code プラグインとして。 このリポジトリはプラグインマーケットプレイスも兼ねているため、どのプロジェクトからでもクローンせずにスキルライブラリを利用できます。

/plugin marketplace add 26zl/cybersec-toolkit
/plugin install cybersec-toolkit@cybersec-toolkit

プラグインに含まれるのはスキルのみです。MCP サーバーは別途設定してください（MCP サーバーを参照）。

その他のクライアントでは。 OpenCode、Codex、Gemini CLI、GitHub Copilot、Cursor、Cline、Goose、Hermes、OpenClaw、DeepSeek Harness は、それぞれ独自の方法でエージェントスキルをサポートしています。scripts/sync-skills.sh は .claude/skills/ を Git の追跡対象外である .agents/skills/ に同期し、その場所を読み込むクライアントで利用できるようにします（--check は差分を報告し、make setup はこの処理を実行します）。Continue と LM Studio では、スキルの自動検出についての説明がありません。代わりに、選択したスキルの内容をルールまたはコンテキストとして渡してください。詳細は docs/AI_CLIENTS.md をご覧ください。

ヘルパースクリプトの依存関係。 一部のベンダー提供スキルには、任意の Python インポートを含むヘルパースクリプトがあります。インポート一覧から生成された .claude/skills/requirements.txt に依存関係が記載されています。scripts/validate_claude_skills.py は、スキルのメタデータ、インデックスの件数、キュレーションの最新状態、ヘルパースクリプトの構文をチェックします。

python3 scripts/audit_skill_dependencies.py --check-declared   # verify declarations
python3 -m pip install -r .claude/skills/requirements.txt      # optional, ideally in a venv

開発

コントリビューションを歓迎します。さまざまなディストリビューションでのインストールテスト、不足しているツールの追加、パッケージのマッピング修正、MCP ワークフローの改善、使用例の作成、実際の CTF、ラボ、バグバウンティ、ペンテスト、DFIR、または防御業務で見つかった問題の報告などをお寄せください。大きな変更については issue を作成し、小規模な修正については内容を絞った PR をお送りください。検証チェックリストは CONTRIBUTING.md をご覧ください。

git clone https://github.com/26zl/cybersec-toolkit.git && cd cybersec-toolkit
make setup    # submodules, MCP deps, sandbox deps, skill mirror
make check    # lint, validators, bats, pytest, sandbox tests

make help で全ターゲットを確認できます。コマンドの詳細は AGENTS.md に記載されています。MCP Python プロジェクトでは uv と exclude-newer = "3 days" を使って依存関係を解決しており、侵害されたアップロードによる影響範囲を抑えるため、新しいリリースは 72 時間無視されます。Dependabot と週次の uv 更新ワークフローにも同じクールダウン期間が適用されます。シェルテストは Linux、macOS、または WSL で実行してください。ネイティブの Windows チェックアウトでは、Bats サブモジュールが CRLF に書き換えられ、$'\r' エラーが発生することがあります。

セキュリティ修正やアップグレード手順を含む各バージョンのリリースノートは、GitHub Releases ページをご覧ください。git log $(git describe --tags --abbrev=0).. で、最新リリース以降に追加された変更を確認できます。

スター履歴

ライセンス

MIT License。詳細は LICENSE をご覧ください。

このリポジトリでは、独自の条件が適用されるサードパーティコンポーネントも再配布しています。CC-BY-SA-4.0（継承が必要で、MIT への再ライセンス不可）のものも含まれます。同梱コンテンツを再配布または改変する場合は、それぞれの条件に従ってください。詳細は THIRD_PARTY_NOTICES.md をご覧ください。

コントリビューションの手順：CONTRIBUTING.md。コミュニティの行動指針：CODE_OF_CONDUCT.md。脆弱性の報告方法：SECURITY.md。

免責事項

このプロジェクトは、教育、防御、および明示的に許可されたセキュリティテストのみを目的として提供されています。自分が所有するシステム、または評価する書面による許可を得ているシステムにのみ使用し、適用されるすべての法律、作業範囲、サードパーティツールのライセンス、およびサービスの利用規約に従ってください。

このツールキットには、攻撃と防御の両方に利用できるツールが含まれています。一部のコマンドは、ネットワークのスキャン、エクスプロイトの実行、システムの変更、またはセキュリティアラートの発生を引き起こす可能性があります。MCP/AI 統合には安全ポリシーが適用されていますが、アクションを実行する前に、対象範囲、プロンプト、コマンド、出力を確認する責任はユーザーにあります。

このリポジトリは、セキュリティツール自体を再配布するものではありません。インストール時に、公式のアップストリームソースから一般公開されているオープンソースプロジェクトをインストールします。合法かつ許可された使用のみを目的としています。

このプロジェクトは「現状有姿」で提供され、保証はありません。メンテナーは、このツールキットの使用による誤用、損害、データ損失、サービスの中断、または法的責任について責任を負いません。

サードパーティのコンテンツは元のライセンスに基づいて同梱されています。詳細は THIRD_PARTY_NOTICES.md をご覧ください。