io.github.26zl/cybersec-toolkit

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

AI統合を内蔵したサイバーセキュリティツールキット。 組み込みのMCP（Model Context Protocol）サーバーにより、MCP対応クライアントはツールレジストリの照会、インストール状態の確認、CTFカテゴリやバグバウンティ対象に対するツールの推奨、そして管理された実行パスを通したインストール済みツールの実行ができます。MCPサーバー（AI統合）へジャンプ。

LinuxとTermux（Android）向けのモジュラーインストーラーを同梱。670以上のツール、18モジュール、14プロファイル、12のインストール方法をカバーします。

他と何が違うのか： ほとんどのツールキットはツールをインストールするところで止まります。ここではAIがそれらを駆動することもできます — 問題の種類を推測し、全モジュール/プロファイルから適切なツールを選び、対話型コンパニオンとしてあなたと協力します。明示的に承認した場合、同じMCPツールチェーンが自律ソルバーループに入ることができます。デフォルトはコンパニオン。自律モードはあなたが求めたときだけ。

対応クライアント

各クライアントの詳細な設定はdocs/AI_CLIENTS.mdを、任意のMCPクライアントで複数エージェントを調整する方法はdocs/ORCHESTRATION.mdを参照してください。

仕組み

2つのエントリポイントが1つのツールレジストリを共有します。オペレーターはbashインストーラーを実行してツールをディスクに配置します。AIエージェントはMCPサーバーと通信して、同じツールを管理されたツールパスを通じて発見、推奨、実行します。tools_config.jsonは、モジュールが定義しMCPアドバイザーが読み取る単一の真実の源であり、CIバリデーターがPython側とbash側の同期を維持します。

Mermaidソース: assets/how-it-works.mmd。

図の読み方: 実線の矢印は実行時またはインストール時のアクション、破線の矢印は検証とコンテキストの関係です。クライアント設定は、FastMCPに到達する前にルート認識ランチャーを通過します。security.pyは、シェルを起動せずに、allowlist、引数チェック、ネットワークポリシーを通じてrun_toolとrun_pipelineを管理します。run_scriptは、デフォルトで無効の別の完全コード実行機能として残ります。Agent Skillsは実行パス外にあります：.claude/skills/が正規であり、scripts/sync-skills.shがポータブルミラーを使用するクライアント向けに.agents/skills/を生成します。

Related MCP server: Enterprise MCP Gateway and Tool Registry

なぜKali（または他のインストーラー）だけではだめなのか？

Kali/Parrot/BlackArchはツールを提供しますが、これは補完であり、置き換えではありません。すでに持っているマシン（Termuxを含む）で動作し、AIコントロールプレーンを追加して、インストール済みツールを1つの管理されたインターフェースで発見、推奨、連鎖、実行できます。すべてのツールが欲しいですか？ディストリビューションで十分です。明示的なポリシーの下でツールを選択して実行できるMCPクライアントが欲しいですか？それがこのギャップです。

信頼と安全性

セキュリティユーザーは偏執的であるべきです — ここで実行されるものとゲートされるものを正確に示します：

• デフォルトで安全なMCP。 初期状態ではCYBERSEC_MCP_ALLOW_EXTERNAL=0がプライベート/ループバック範囲に解決されないネットワークターゲットを拒否し、CYBERSEC_MCP_ALLOW_SCRIPTS=0がrun_scriptを無効にします。外部スコープ/スクリプト実行には明示的にオプトインします。

• 管理されたツール実行は1つのゲートを通過（mcp_server/security.py）：レジストリのallowlist、シェルなし（create_subprocess_exec、決してshell=Trueではない）、引数のサニタイズ、ツールごとのブロックフラグのdenylist（例：sqlmap --os-shell、nmap -iL、ファイルリスト/ターゲットインジェクションフラグ）、ターゲット/ネットワークポリシー、レート制限、出力上限、タイムアウト。

• 実行ポリシーはOSサンドボックスではありません。 許可されたツールはMCPプロセスユーザーの権限で実行され、一部のセキュリティツールは子プロセスを起動したりプラグインをロードしたりできます。run_scriptを無効化してもそのエンドポイントが無効になるだけです。MCPサーバーは最小権限ユーザーとして、または信頼できないターゲットに適した分離境界内で実行してください。

• ツール認識ポリシーはソルバーのハードコーディングではありません。 ソルバーはレジストリ/アドバイザーからツールを選択します。ポリシーレイヤーは、実際のターゲットとヘッダー、ワードリスト、出力パス、設定ファイル、またはターゲットリストフラグを区別するのに十分なCLI文法のみを理解します。これにより、ファイルリスト/設定フラグがスコープチェックをバイパスすることなく、通常のコマンドを使用可能にします。

• 監査証跡であり、漏洩ではない。 アクションは、ユーザーの状態ディレクトリ（デフォルトでは~/.local/state/cybersec-tools-mcp/audit.log）の下にある所有者のみ（0600）のローテーションログにJSONとして記録されます。スクリプト本体は永続化されません — 相関のために不可逆なSHA256 + 長さのみが記録され、資格情報の形をした文字列はツール引数から編集されます。

• インストーラーでの最小権限。 ルートとして実行されますが、クローンされたリポジトリのビルドとpip/cargo/gemインストールでは呼び出し元ユーザー（$SUDO_USER）に権限を落とします。バイナリリリースはチェックサムが公開されている場合にSHA256で検証されます。

• デュアルユースツールはゲートされます。 C2およびフィッシングフレームワーク（Sliver、Caldera、gophish、evilginx、…）はデフォルトでオフであり、--include-c2（redteam/fullプロファイル）でのみインストールされます。MCPレイヤーはこれを反映し、それらを自動実行することはありません。

• 許可された使用のみ。 SECURITY.md、サプライチェーンモデル、および免責事項を参照してください。

インストール

必要なすべてのランタイム（Python、Go、Ruby、Java、Rust、Node.js）、開発ライブラリ、pipx、ビルドツールが自動的にインストールされます。唯一の前提条件はサポートされているLinuxディストリビューションです。WindowsとmacOSはサポートされていません（WSLまたはDockerを使用してください）。

Dockerは唯一の例外です — C2フレームワーク、MobSF、BeEF、BloodHound、TheHive、またはCortex（--enable-docker）が必要な場合は手動でインストールしてください。Dockerインストールドキュメントを参照してください。 GitHub認証が推奨されます。インストーラーは約30のバイナリリリースをダウンロードし、GitHubに30以上のAPI呼び出しを行います。認証がない場合、60リクエスト/時間に制限され、一部のダウンロードが失敗する可能性があります。認証がある場合、制限は5,000/時間です。最も簡単な方法：

# Install gh CLI and log in (one-time) — the installer auto-detects it
sudo apt install gh && gh auth login

または、個人アクセストークンをエクスポートします（スコープは不要）：

export GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx

最新リリースから（固定され安定 — 推奨）：

# Newest tag is on the Releases page: https://github.com/26zl/cybersec-toolkit/releases
git clone --depth 1 --branch v1.1.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イメージはオプトインのままです。現在のプラットフォームでサポートされる完全なレジストリを明示的に希望する場合は、--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
sudo ./install.sh --dry-run --profile ctf              # Preview without installing

マシンが準備できているか不明ですか？まず読み取り専用の事前チェックを実行してください — ルートは不要で、何もインストールしません：

./install.sh --doctor                                  # Distro, prerequisites, MCP server, tool registry

Dockerで試す

ビルド済みイメージをプル（ローカルビルド不要）：

docker run --rm ghcr.io/26zl/cybersec-toolkit --profile ctf

または自分でビルド：

docker build -t cybersec-toolkit .
docker run --rm cybersec-toolkit --profile ctf

Podmanはドロップイン代替として機能します — dockerをpodmanに置き換えます（またはalias docker=podman）。ルートレスビルドと実行がサポートされています。以下のCompose例では、podman composeを使用してください（composeプロバイダーのインストールが必要）。

または同梱のComposeファイルを使用（installerサービスをビルドして実行）：

docker compose run --rm installer --profile ctf

イメージはtoolkitユーザーにパスワードなしのsudoを付与し、インストーラーがシステムパッケージを管理できるようにします。コンテナ内のコードはルート権限を持つものとして扱ってください。特にrun_scriptが有効な場合や機密のホストパスがマウントされている場合、イメージはセキュリティサンドボックスではありません。

macOS（Apple Silicon）： 両方のコマンドに--platform linux/amd64を追加して、x86エミュレーションで実行します：

docker build --platform linux/amd64 -t cybersec-toolkit .
docker run --rm --platform linux/amd64 cybersec-toolkit --profile ctf

Termux（Android）：

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

sudo ./install.sh --help                # Full help
sudo ./install.sh --list-profiles       # Show profiles
sudo ./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 Security note below)
sudo ./install.sh --require-checksums   # Fail if 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
sudo ./install.sh --list-sessions       # List install sessions and exit
sudo ./install.sh --rollback <id|last>  # Rollback tools installed in a session
sudo ./install.sh --version             # Show installer version and exit
sudo ./install.sh --enable-docker       # Pull Docker images
sudo ./install.sh --include-c2          # Include C2 frameworks (needs --enable-docker)
sudo ./install.sh -j 8                  # 8 parallel install jobs (default: 4)
sudo ./install.sh -v                    # Verbose / debug output

--toolは、完全な依存関係セットアップを実行せずに指定したツールのみをインストールします。ドライラン時間の見積もりはメソッド間のインストールエントリを数えるため、重複排除された670以上のツールレジストリよりも見積もりが高くなることがあります。

インストーラーは12の異なるインストール方法で670以上のツールを調整します。時間は、スクリプト言語では高速化できないI/Oバウンドの操作に費やされます：

現在のメソッド別ツール数は、./install.sh --dry-run を実行すると確認できます — ライブの内訳が出力されるため、ここに記載した数値が古くなることはありません。最も時間がかかる段階は、最も多くコンパイルまたは展開を行うもの（apt/dnf と Go）であり、ツールの総数ではありません。Cargo はソースからコンパイルしますが、対象はわずか数個のツールのみです。

インストーラーは可能な限り並列化されています（デフォルトで -j 4）。共有ロックを持つメソッド（apt、pipx、cargo）は順次実行する必要があります。インストール時間を短縮するには：

• --profile lightweight または --module <name> を使用して、必要なものだけをインストールする

• --skip-cargo を使用して Rust のコンパイル（ツールあたりの最遅メソッド）をスキップする

• -j 8 で並列度を上げ、Go/git/binary のダウンロードを高速化する

• 繰り返しインストールする場合は apt-cacher-ng プロキシを設定する

プロファイル

モジュール

インストールメソッド

インストール後スクリプト

すべてのスクリプトは Linux では root（sudo）が必要で、--help に対応しています。Termux では root は不要です。

--deep-clean は Go のモジュール/ビルドキャッシュ、Cargo レジストリ、pip/pipx/npm/gem キャッシュ、孤立した pipx venv、古いシンボリックリンク、ログファイルを削除します。--remove-deps を追加すると Rustup ツールチェーンも削除されます。

MCP サーバー（AI 統合）

MCP（Model Context Protocol） は、AI アシスタントが外部ツールを使用できるようにするオープン標準です。このプロジェクトには MCP サーバーが含まれており、MCP 対応の AI（Claude Code、Claude Desktop、Cursor など）に 670 以上のツールレジストリへの完全な読み取りアクセスを提供します。さらに、インストールの確認、プロファイルの推奨、ツールの実行も可能です。AI は倫理的ハッキングの対話型パートナーになります。すべてのツール、インストール済みのツールを把握し、それらを実行できます。

AI ができること

コンテンツを学べるS P対応、MCPクライアントは各ツールとそのインストール状態を照会し、ガバナンスされたツール呼び出しを連結し、 出力を解析し、見つかった情報に基づいて方向転換できます。スクリプト実行には別途オプトインが必要です。

外部偵察 → アタックサーフェス（CYBERSEC_MCP_ALLOW_EXTERNAL=1 が必要、許可されたスコープのみ）

• 「target.comのアタックサーフェスを列挙して、悪用可能なものをすべて検出する」 — amass / subfinder をファンアウト → httpx で名前解決とプローブ → whatweb でフィンガープリント → nuclei テンプレートを実行 → ffuf でコンテンツディスカバ… → そしてホストを露出度の順にランキングして、次のステップを提案します

• 「/go?url= でオープンリダイレクトを発見 — それを武器化する」 — curl で検証し、SSRF / OAuthトークン盗用のPoCを組み立てて、悪用可能なコールバックを探します

ウェブアプリケーションの脆弱性を突く

• 「ログインエンドポイントのSQLiを確認して攻略する」 — sqlmap で確認・ダンプ（破壊的な--os-shell / --os-cmd はポリシーでブロック）、その後 run_script で認証バイパスを自動化し、PoCに必要な範囲だけを取得します

• 「GraphQLのイントロスペクションが有効 — それをマッピングしてIDORを探す」 — スキーマを取得し、クエリを生成し、オブジェクトIDをファジングして、認証済みレスポンスと未認証レスポンスを比較します

その他の Active Directory / 内部ネットワーク

• 「10.10.0.0/24に低権限の資格情報 — ドメイン管理者パスを見つける」 — bloodhound でデータを収集し、impacket（GetUserSPNs.py）でKerberoast攻撃を仕掛け、hashcat でTGSをクラップし、netexec で横方向の移動を検証します — すべてKali VM上でSSH経由

• 「DCSync権限を調べ、経路があればダンプする」 — レプリケーションACLを列挙し、DCに対して secretsdup.py を実行します

バイナリエクスプロイト・リバースエンジニアリング

• 「この64ビットバイナリ用の ret2libc エクスプロイトを構築する」 — checksec / readelf でトリアージ、ROPgadgetでガジェットを探し、puts@plt 呼び出しを介してlibcをリークし、venv="pwntools" で完全な pwntools チェーンを作成して、ローカルでシェルを取得します

• 「stripされたバイナリからアルゴリズムを復元する」 — objdump / radare2 のディスアセンブリを目的に応じた解析へパイプし、その後 run_cript で再実装して動作を検証します

暗号

• 「このRSAを解読する — 小さな e 、複数の暗号文」 — 攻撃法（Håstad / common -modulus / Wiener）を検出し、venv内の pycryptodome + sympy で解いて平文を返します

• 「このJWTはHS256で弱い鍵が使われている」 — 署名シークレットをクラックして管理者トークンを偽送します

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

• 「このテクニックについてSigmaルールを作成し、自分のSIEMに変換する」 — ルールを作成し、sigma-cliでターゲットバックエンド（Splunk / Elastic）用にレンダリングします

• 「横移動の異常を調べるこのWindowsイベントログである」 — SigmaルールでEVXに対して chainsaw を実行し、ホストとタイムラインごとにヒットをまとめます

• 「これらのサンプルからYARAルールを作成し、ツリー全体をスキャンする」 — yara のシグネチャを生成し、再帰的に実行します

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

• 「このメモリダンプをタイムライン化する」 — volatility3 のプラグイン（pslist、netscan、malfind）を一括実行し、それらを1つのストーリーに連結します

• 「この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 は、引数のサニタイズ、ネットワークポリシー、レート制限、監査ログが適用されます。run_script はデフォルトでは無効です。有効にすることはMCPサーバーのファイルシステムとネットワーク権限での完全コード実行のオプトインになるためで、外部ターゲットへのポリシーはスクリプトをサンドボックス化しません。破壊的なフラグ（--os-shell、-rf、--exploit、…）はガバナンスされツールパスでブロックされます。テストが許可されたシステムに対してのみ使用してください。

クイックスタート

には [uv] が必要です（https://docs.astral.sh/uv/）。Claude Code はプロジェクトの .mcp.json を直接使用できます。デフォルトでは、スクリプトおよび外部ネットワークターゲットを無効化した状態でMCPサーバーをstdioで実行します:

{
  "mcpServers": {
    "cybersec-tools": {
      "command": "uv",
      "args": ["run", "--directory", "mcp_server", "fastmcp", "run", "server.py", "--transport", "stdio", "--no-banner"],
      "env": {
        "CYBERSEC_MCP_ALLOW_EXTERNAL": "0",
        "CYBERSEC_MCP_ALLOW_SCRIPTS": "0"
      }
    }
  }
}

Claude Codeを再起動します。 /mcp には15個のツールが表示されます。

その他の MCP クライアント（Codex, Cursor, ローカルLLM）

MCPはオープンな標準規格なので、MCP対応のクライアントであれば同じstdioサーバーを利用できます。リポジトリのルートからの起動コマンド:

uv run --directory mcp_server fastmcp run server.py --transport stdio --no-banner

--directory mcp_server は作業ディレクトリからの相対パスです。クライアントがサブディレクトリからサーバーを起動する可能性がある場合、ルートを認識するランチャーをリポジトリルートで使用してください:

bash scripts/mcp-launch.sh

リポジトリの外からは、対応する拡張コマンドラインの絶対パスを使用します:

bash /path/to/cybersec-toolkit/scripts/mcp-launch.sh

• Codex — プロジェクトの .codex/config.toml が含まれています（最初に Git ルートを解決するため、任意のサブディレクトリから動作します）。Codex の主要な設定は ~/.codex/config.toml です。プロジェクトファイルが認識されない場合は、[mcp_servers.cybersec-tools] ブロックをホーム設定にコピーしてください。

• Cursor / Continue / Cline / Goose — クライアントの MCP 設定 UI または設定ファイルに同じ起動コマンドを追加します（クライアントの作業ディレクトリがリポジトリルートでない場合は絶対パスを使用してください）。

• LM Studio (≥0.3.17) — LM Studio 自体が MCP ホストであるため、ブリッジは不要です。mcp.json（Cursor 表記、.mcp.json と同じ mcpServers 構造）にサーバーを追加します。LM Studio の作業ディレクトリはリポジトリルートではないため、絶対パスまたは git-root ラッパーを使用してください。LM Studio の API 経由で MCP を使用するには ≥0.4.0 と、/api/v1/chat や /v1/responses などの MCP 対応エンドポイントが必要です。

• Ollama — Ollama はモデルランタイムであり、MCP ホストではありません。MCP 対応エージェント（例: Kit）を前面に配置し、上記の起動コマンドを指定してください。

• その他のローカル LLM — 素のモデルは単独では MCP を話せません。任意の MCP 対応ホスト（LM Studio、Cline、Continue、Goose、Kit、または mcpo のような MCP→OpenAPI ブリッジ経由の Open WebUI）の背後で実行し、そのホストに上記の起動コマンドを指定してください。

セキュリティ上の注意: まずはこの 1 つのサーバーだけから始めてください。このサーバーはすでに引数のサニタイズ、ネットワーク許可リスト、レート制限、監査ログを強制し、スクリプト実行と外部ターゲットはデフォルトで無効になっています。承認されたスコープがない限りそれらはオフのままにし、人間がループ内でツール承認を行うホストを優先してください。

ベンダーに依存しないリポジトリの説明は AGENTS.md にあります（Codex や多くのエージェンティックツールがネイティブに読み取ります）。Claude Code は CLAUDE.md を読み取ります。

WSL からの接続（例: Kali Linux）

MCP サーバーは stdio 上で動作するため、Claude Code が起動できる任意の環境から動作します。WSL 内にインストールされたツールを使用するには:

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

Docker からの接続

{
  "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 を使用すると、AI が Python または Bash スクリプトを作成・実行できます。これには CYBERSEC_MCP_ALLOW_SCRIPTS=1 が必要で、OS サンドボックス化されておらず、CYBERSEC_MCP_ALLOW_EXTERNAL による制約も受けません。有効にすると、スクリプトに MCP サーバープロセスと同じファイルシステムおよびネットワーク権限が付与されます。オプトインする前に生成されたコードとスコープを確認してください:

{
  "mcpServers": {
    "cybersec-tools": {
      "command": "uv",
      "args": ["run", "--directory", "mcp_server", "fastmcp", "run", "server.py", "--transport", "stdio", "--no-banner"],
      "env": {
        "CYBERSEC_MCP_ALLOW_SCRIPTS": "1",
        "CYBERSEC_MCP_ALLOW_EXTERNAL": "0"
      }
    }
  }
}

Venv サポート

一部のパッケージ（例: pwntools）は古い Python を必要とします。venv パラメータを使用すると、AI がスクリプトごとに適切なインタープリタを選択できます:

# One-time setup: create a venv with pwntools
python3.12 -m venv ~/.ctf-venvs/pwntools
~/.ctf-venvs/pwntools/bin/pip install pwntools z3-solver

AI はその後、run_script("from pwn import *; ...", venv="pwntools") を自動的に使用します。デフォルトの MCP 環境には FastMCP と Python 標準ライブラリが含まれています。名前付き venv なしで requests、pycryptodome、beautifulsoup4、Pillow、または NumPy を使用する前に、cd mcp_server && uv sync --extra ctf-core でオプションのヘルパーセットをインストールしてください。CYBERSEC_MCP_VENVS_DIR を設定すると、デフォルトの ~/.ctf-venvs/ の場所を上書きできます。

手動スクリプト

manual_scripts/ ディレクトリには、AI がユーザーのために作成する永続的なスクリプト（複雑なエクスプロイト、多段階ソルバー、パーサー、プロトコルヘルパー、1 回の実行で消えるべきではない再利用可能なツール）が保存されます。コンパニオンモードでは、AI がスクリプトを提案し、承認または明確な「続行」の後にのみ書き込み・実行します。オプトインの autonomous モードでは、通常のツールとパイプラインが進展しなくなり、プログラミングロジックが最小の信頼できる経路である場合、AI は run_script を介してスコープを限定したヘルパーを作成、保存、実行できます。curl などの単純な偵察/HTTP コマンドは run_tool 呼び出しのままであり、スクリプトはツールがきれいに表現できないロジック用です。

サーバーのテスト

cd mcp_server && uv run fastmcp dev server.py

これにより、Web ベースの MCP Inspector が開き、各ツールを対話的にテストできます。

Claude Desktop のセットアップと完全なドキュメントについては、mcp_server/README.md を参照してください。

ヘルプ歓迎

このプロジェクトは意図的に大規模であり、コミュニティの助けを大いに歓迎します。

有用な貢献には、さまざまなディストリビューションでのインストールテスト、不足しているツールの追加、パッケージマッピングの修正、MCP ワークフローの改善、使用例の作成、ドキュメントの充実、実際の CTF、ラボ、バグバウンティ、ペンテスト、DFIR、または防御的ワークフローからの粗い部分の報告が含まれます。

大きな変更には issue を開き、小さな修正には焦点を絞った PR を送ってください。検証チェックリストについては CONTRIBUTING.md を参照してください。

開発

公開コントリビューター向けドキュメントは CONTRIBUTING.md にあります。クイックスタートは次のとおりです:

git clone https://github.com/26zl/cybersec-toolkit.git && cd cybersec-toolkit
make setup    # submodules + MCP deps + skill mirror (Codex-ready)
make check    # core local checks — shellcheck, validators, bats, ruff, pytest

make help はすべてのショートカット（lint、test、validate、curate、sync-skills、check-skills、mcp、docker など）を一覧表示します。各ターゲットが実行する生のコマンドは CLAUDE.md / AGENTS.md にあります。

MCP Python プロジェクトは uv を [tool.uv] exclude-newer = "3 days" とともに使用します。新しい依存関係の解決は、依存関係の混乱と侵害されたリリースの爆発半径を減らすために、過去 72 時間にアップロードされたパッケージを意図的に無視します。Dependabot は同じ 3 日間のクールダウンを使用し、毎週の uv 更新ワークフローも同じポリシーを継承します。

このリリース期間ポリシーは、プロジェクトのブートストラップ/ランタイム依存関係のみに適用されます: MCP Python パッケージ、CI アクション、およびプロジェクトの実行に必要な Docker ビルド入力です。レジストリからインストールされるサイバーセキュリティツールを遅延させたり固定したりしません。これらのツールは意図的にモジュールインストーラーと更新フローに従うため、オペレーターは最新のスキャナー、エクスプロイト、シグネチャ、調査ユーティリティを入手できます。

シェルテストは Linux または WSL で実行してください。ネイティブ Windows チェックアウトは、ベンダー提供の Bats サブモジュールを CRLF で書き換え、$'\r' エラーを引き起こす可能性があります。

エージェントスキル

このリポジトリには、正規の .claude/skills/ ソースツリーの下に 872 のエージェントスキルが含まれています。Claude Code はそのツリーを直接発見します。scripts/sync-skills.sh は、互換性のあるクライアント向けにポータブルな .agents/skills/ ミラーを生成します。スキルはタスクに基づいてオンデマンドでアクティブ化され、コンテキストを永続的に消費しません。このうち 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、サプライチェーン/製品セキュリティ）

• multica-ai/andrej-karpathy-skills からの 1 のコーディングエージェントワークフロースキル（MIT）

• 6 の CTF 方法論スキル（ctf-crypto、ctf-pwn、ctf-web、ctf-rev、ctf-forensics、ctf-stego）

• 4 のバグバウンティ方法論スキル（bounty-recon、bounty-web、bounty-api、bounty-mobile）

• BugHunter (claude-bug-bounty) からの 10 のバグバウンティワークフロースキル（MIT）

• SnailSploit Claude-Red からの 58 の攻撃的方法論スキル（MIT）

• Trail of Bits からの 14 のコード監査スキル（CC-BY-SA 4.0）

• コミュニティプロジェクト mukul975/Anthropic-Cybersecurity-Skills からの 754 の運用ハウツー（Apache 2.0）

• Transilience からの 4 の高レベルワークフロー（MIT）

ソースとカテゴリのインデックスは .claude/skills/SKILLS.md にあります。

Claude Code プラグインとしてインストール

このリポジトリは プラグインマーケットプレイス（.claude-plugin/）を兼ねているため、手動でクローンしなくてもスキルライブラリ全体を任意のプロジェクトに取り込めます:

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

プラグインは .claude/skills/ の下のスキルを公開します（.claude-plugin/plugin.json の skills フィールドで宣言）。MCP サーバーは .mcp.json を介して個別に設定されます — MCP サーバー を参照してください。

サポートされているクライアント間でこれらのスキルを使用

エージェントスキルは Markdown とオプションのヘルパーファイルですが、発見とアクティブ化は MCP 機能ではなくクライアント機能です。Claude Code、OpenCode、Codex、Gemini CLI、GitHub Copilot、Cursor、Cline、Goose、Hermes、OpenClaw は、さまざまなパスまたは設定を通じてエージェントスキルをサポートしています。scripts/sync-skills.sh は、その場所を使用するクライアント向けに、リポジトリの .claude/skills/ ソースを .agents/skills/ にミラーリングします:

scripts/sync-skills.sh            # mirror .claude/skills/ -> .agents/skills/
scripts/sync-skills.sh --check    # report drift without writing (exit 1 if out of date)

make setup（開発 を参照）がこのミラーステップを自動的に実行します。

.claude/skills/ が単一の情報源であり、.agents/skills/ は生成され git 無視されるため、スキルを編集した後は同期を再実行してください。Continue と LM Studio は MCP サーバーを使用できますが、どちらのクライアントも現在、このリポジトリの SKILL.md ファイルの自動発見を文書化していません。スタンドアロンの SKILLS.md インデックスは手動コンテキストにすぎず、オンデマンドアクティブ化は追加されません。これらのクライアントでは Continue のルール/プロンプトを使用するか、選択したスキルコンテンツをコンテキストとして提供してください。クライアント固有のパスと制限については docs/AI_CLIENTS.md を参照してください。

scripts/validate_claude_skills.py は、スキルのメタデータ、インデックス数、キュレーションの鮮度、Python および PowerShell のヘルパースクリプト構文をチェックします。ベンダー提供のスキルヘルパースクリプトには、オプションのタスク固有 Python インポートを含めることもできます。これらのインポートは .claude/skills/requirements.txt で宣言され、ヘルパースクリプトのインポートインベントリから生成されます:

python3 scripts/audit_skill_dependencies.py --check-declared
python3 scripts/audit_skill_dependencies.py --write-requirements
python3 -m pip install -r .claude/skills/requirements.txt

スキルのランキング/キュレーションは .claude/skills/CURATION.md と .claude/skills/curation.json にあります。再生成するには:

python3 scripts/curate_claude_skills.py --write

ツールの場所

非システムツール（pipx、Go、Cargo、git、バイナリリリース）は、Linux では /usr/local/bin/、Termux では $PREFIX/bin にインストールされます。システムパッケージはデフォルトの場所（/usr/bin/）にインストールされます。

Docker イメージ（オプション）

--enable-docker でのみ使用されます。Docker がインストールされておらず、--enable-docker が設定されている場合、インストーラーは Docker を先にインストールするよう求めるエラーで終了します。

ディストリビューションのサポート

Debian/Ubuntu/Kali が主なターゲットです -- 670 以上の完全なレジストリが利用可能で、最も強力なテストカバレッジを備えています。Fedora/Arch/openSUSE では約 10〜20 のパッケージが自動的にスキップされ（ディストリビューション固有）、統合ワークフローの対象です。WSL と ARM は実質的にサポートされていますが、専用の CI ジョブはまだありません。Windows と macOS は検出され、明確なエラーメッセージとともにブロックされます。

サプライチェーンモデル

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

• システムパッケージ: ディストリビューションのリポジトリ（apt、dnf、pacman、zypper、pkg）によって GPG 署名されています。

• pipx/Go/Cargo/Gem/npm: レジストリからダウンロード（署名検証なし、pipx は venv 内に分離）。

• バイナリリリース: チェックサムファイルが利用可能な場合は SHA256 を検証し、不一致の場合はハードフェイルします。チェックサムファイルが公開されていない場合も失敗させるには、--require-checksums または --production プリセットを使用します。警告: --fast は、チェックサムを公開しているリリースも含め、すべてのチェックサム検証を無効にします。本番環境や CI 環境では使用しないでください。

• MCP Python 依存関係: uv によって 3 日間の exclude-newer ウィンドウで解決されます。Dependabot も依存関係の PR を提案するまでに 3 日間待機します。これはインストールされたセキュリティツールには適用されません。

• Go SDK: 利用可能な場合は go.dev が公開するハッシュに対して SHA256 を検証します。API 障害時は警告し、--require-checksums ではハードフェイルします。

• Git リポジトリ: HEAD でクローンされ、依存関係は分離された venv にインストールされます（setup.py は実行されません）。

• ソースからのビルド: make を実行します（Linux では root として）。ビルドするものを確認してください。

• ツールキットの Docker ビルド: Ubuntu と uv のソースはダイジェストで固定されていますが、apt パッケージは現在の署名済み Ubuntu リポジトリから解決されます。再現ビルドはビット単位では再現可能ではありません。

• オプションのツールイメージ: ダイジェストではなく可変タグでプルされます（明示的な latest タグをいくつか含む）。--production はこれらのイメージを固定または検証しません。

.versions ファイルには、何がいつインストールされたかが記録されます。

既知の制限事項

チェックサム検証は、デフォルトではベストエフォートです。一部のアップストリームリリースはチェックサムや署名を公開していないため、そのような場合、ダウンロードは暗号検証なしで進行することがあります。チェックサムファイルが利用できない場合にフェイルクローズするには、--production（または --require-checksums）を使用します。このプリセットは、Git クローン、言語パッケージレジストリ、ソースからのビルドツールを固定しません。これらは引き続きアップストリームのリリースチャネルを追跡します。Go SDK のダウンロードは、API に到達可能な場合、go.dev に対して SHA256 検証されます。厳格なチェックサムモードでは、到達できない場合はハードフェイルします。

--fast は、チェックサムを公開しているリリースも含め、バイナリリリースのすべてのチェックサム検証（SHA256 チェックとチェックサム欠落警告の両方）をスキップします。これは、整合性検証を速度と引き換えにします。--require-checksums および --production とは相互に排他的です。CI パイプラインやサプライチェーンの整合性が重要な環境では --fast を使用しないでください。

Windows Defender の誤検知

このリポジトリを Windows マウントパス（例: C:\Users\<you>\... や、WSL で作業中に Windows から見えるフォルダ）にクローンすると、Microsoft Defender やその他のウイルス対策製品が個々のファイルを隔離する可能性があります。防御コンテンツ（IOC 参照テーブル、難読化された PowerShell のサンプル、マルウェア解析スニペット、.claude/skills/、writeups/、mcp_server/ の一部にあるエクスプロイト PoC 文字列）には、実際の攻撃者が使用するものと同じバイト文字列が含まれているため、シグネチャベースおよび ML ベースのエンジンがそれらをフラグ付けする可能性があります。一般的な検出名には、Trojan:Script/Wacatac.B!ml、HackTool:*、一般的な Heur.* の判定などがあります。

これらはセキュリティツールキットの文脈では誤検知です。Windows でリポジトリを操作するには、次の 3 つのオプションがあります。

1. リポジトリフォルダの Defender の除外を追加する（個人用開発マシンには推奨）。管理者 PowerShell から次を実行します:

   Add-MpPreference -ExclusionPath "C:\path\to\cybersec-toolkit"

2. 隔離された個々のファイルを復元するには、Windows セキュリティ -> ウイルスと脅威の防止 -> 保護の履歴 -> 「デバイス上で許可」を使用します。ファイル単位ですが、更新時の再検出を防ぐことはできません。

3. リポジトリを WSL ファイルシステム内に置く（例: ディストリビューションの ~/cybersec-toolkit）。Defender はデフォルトで WSL2 の vhdx をスキャンしないため、検出は発生しません。scripts/sync-wsl.sh は MCP サーバーのサブディレクトリに対してすでにこれを実行しています。

Defender によって削除されたファイルは、git status で D と表示されます。コンテンツは git 履歴に保持されます。除外が設定されたら、git checkout -- <path> で復元します。

ライセンス

MIT ライセンス -- 詳細は 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 を参照してください。