cybersec-toolkit

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

一个由 AI Agent 驱动、按你设定的规则运行的安全工具包。 一条命令即可在 Linux 或 Termux 上安装 670 多种安全工具。MCP（Model Context Protocol） 服务让 Claude Code、Codex、Gemini CLI、OpenCode 和其他 MCP 客户端能够发现、推荐并通过受管控的执行路径运行这些工具；默认情况下，工具在一次性 Kata Containers VM 中运行。872 个 Agent Skills 提供了 CTF、渗透测试、漏洞赏金、DFIR 和蓝队工作的实践方法。

不同之处： 大多数工具包止步于_安装_工具。而在这里，AI 还可以_驱动_这些工具：推断问题类型，从所有模块和配置中选择工具，并与你逐步解决问题。经你明确授权后，同一套工具链还可以运行自主求解循环。默认协作；只有在你要求时才自主运行。 它与 Kali、Parrot 或 BlackArch 互为补充，而非取而代之：它可在你现有的设备上运行，也包括 Termux。

快速开始 · 工作原理 · 信任与安全 · 安装程序 · MCP 服务 · Agent Skills · 开发 · 许可证

快速开始

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（.mcp.json 也会被 GitHub Copilot CLI 读取）、Codex、Gemini CLI 和 OpenCode 的受跟踪配置会通过 scripts/mcp-launch.sh 启动服务，并禁用外部目标和脚本执行。选择工具的运行位置：

Kata 需要 KVM：在 macOS、Windows 和不支持嵌套虚拟化的 VM 上，请使用主机模式。

3. 重启客户端。 随后会显示 15 个工具（在 Claude Code 中使用 /mcp）。接着提出你的需求，例如“分析这个二进制文件”或“绘制我的实验环境 10.10.0.0/24 的攻击面”。

工作原理

两个入口共用一个工具注册表。__运维人员__运行 bash 安装程序，将工具安装到磁盘上：可以安装在主机上，也可以在构建时安装到沙箱镜像中。__AI Agent__与 MCP 服务通信（默认在 Kata VM 中运行），通过统一的受管控路径发现、推荐和执行这些工具。tools_config.json 是唯一事实来源，由各模块定义，并由 MCP 顾问读取；CI 验证器确保 Python 和 bash 两侧保持同步。

实线箭头表示运行时或安装操作；虚线箭头表示验证和上下文关系。客户端配置通过能够识别 root 的启动器接入，启动器通过 Sandcastle Kata 提供程序（sandbox/kata.mjs）启动 VM；或者使用 --local 在主机上启动服务。security.py 通过允许列表、参数检查和网络策略管控 run_tool 和 run_pipeline，而不调用 shell。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）：注册表允许列表、禁止 shell（使用 create_subprocess_exec，绝不使用 shell=True）、参数清理、按工具设置的阻止标志拒绝列表（例如 sqlmap --os-shell、nmap -iL、文件列表和目标注入标志）、目标与网络策略、速率限制、输出上限和超时。该策略了解足够多的 CLI 语法，能够区分目标与标头、字典、输出路径或目标列表标志。工具输出会在传给模型前剔除终端转义序列和 LLM 控制标记，并标记写给 AI 读者的行。
• 默认在一次性 VM 中运行工具。 启动器会启动一台 Kata Containers VM，它有自己的内核；除可选的 CYBERSEC_SANDBOX_WORKSPACE 挂载外，不访问主机文件系统；没有 Docker socket；使用已移除所有 capability 的非 root 用户；并设有内存、CPU 和进程限制。客户端断开连接时，VM 会被销毁。启动失败时会安全关闭，而不会回退到主机；--local 是显式选择退出沙箱的选项。
• 了解限制。 VM 并非网络边界：它可以访问 Docker 网络所能访问的任何内容，而 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 可禁用它们。
• 留存审计记录，避免泄露。 操作会以 JSON 行格式记录到用户状态目录下仅所有者可访问（0600）的轮转日志中（默认路径为 ~/.local/state/cybersec-tools-mcp/audit.log）。脚本正文绝不会存储，只记录其 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）以及 blueteam、redteam、blockchain 和 mobile 配置的必需项；这些配置默认启用 Docker 镜像（参见配置）。请自行安装：Docker Engine 文档。
• __GitHub 身份验证__为推荐项。安装程序会下载约 50 个发行版二进制文件，并调用 GitHub API 约 50 次以上；未通过身份验证的请求每小时限制为 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 个模块中的标准工具。除非通过配置启用（参见配置中的 Docker 和 C2 列），否则 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
./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 silicon 上，需在 docker build 和 docker run 命令中添加 --platform linux/amd64。Podman 可直接替代 Docker（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 也需要；verify.sh 和其他 backup.sh 命令以当前用户身份运行。Termux 无需 root 权限。没有终端时，请为 remove.sh（以及 install.sh --rollback）传入 --yes。

完整移除后，--deep-clean 会清理 Go 模块/构建缓存、Cargo 注册表、pip/pipx/npm/gem 缓存、孤立的 pipx 虚拟环境、过期的符号链接和日志文件。添加 --remove-deps 还会清理 Rustup 工具链。

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）；当 remove.sh 移除由此工具包安装的 Metasploit 时，也会删除该软件源。NodeSource 的设置脚本还会添加 NodeSource 软件源和密钥，这些会保留。移除后，apt 仍会信任 NodeSource；如果不再需要，请手动删除其软件源。
• Arch：在 /etc/pacman.conf 中启用 ParallelDownloads。
• 基于 apt 的发行版上会安装 snapd，供仅通过 snap 提供的工具使用。
• 运行时：位于 /usr/local/go 的 Go SDK；以及安装在调用用户主目录中的 rustup、cargo 和 uv。
• 位于 /opt、/opt/pipx 和 /usr/local/bin 中的__工具__。

此工具包仅在本机保存以下数据：

• 检出目录中的 .versions、.install_sessions/ 和 *.log：安装来源记录和日志。
• ~/.local/state/cybersec-tools-mcp/：MCP 审计日志及其轮转文件、remote_hosts.json，以及 Agent 防护机制的 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 验证；严格模式下，如果 API 不可访问，则会失败。
• Git 仓库：在 HEAD 克隆；绝不会运行仓库自身的 setup.py。requirements.txt 会以调用用户的身份安装到每个仓库专属的 venv 中，其中依赖的 sdist 仍可能进行构建；在严格模式（--production 或 --require-checksums）之外，如果固定版本的安装失败，则会放宽 == 为 >= 后重试。
• 从源代码构建：以调用用户的身份运行 make，而不是以 root 身份运行。请审核要构建的内容。
• MCP Python 依赖项：由 uv 使用 3 天的 exclude-newer 时间窗口解析，Dependabot 也会等待相同的 3 天。此规则不适用于安全工具本身，它们会跟随各自的上游发行渠道。
• 工具包 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 多种工具的注册信息、安装状态和推荐内容，并受管控地执行已安装的工具。Agent 可了解所有工具、哪些工具可用，以及如何将它们串联起来。

支持的客户端

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 客户端协调多个 Agent，请参阅 docs/ORCHESTRATION.md。

该服务已发布到 官方 MCP 注册表，名称为 io.github.26zl/cybersec-toolkit，并已在 Glama 上列出：

AI 能做什么

除非传入 --local 或设置 CYBERSEC_SANDBOX_MODE=local，否则 scripts/mcp-launch.sh 会在 Kata Containers 虚拟机内启动服务。该虚拟机由 Sandcastle 隔离沙箱提供程序（sandbox/kata.mjs）创建，该提供程序会固定 Kata 运行时；同一提供程序也可用于 Sandcastle Agent 编排循环，而非 MCP 客户端。启动失败时会安全地停止：如果缺少运行时、沙箱镜像、KVM 设备、Node.js 或启动器依赖项，服务会停止并说明原因，而不会退回到主机运行。./install.sh --doctor 会报告沙箱是否就绪。设置、调优和威胁模型见 docs/SANDBOX.md。

• 虚拟机有自己的工具集。 沙箱镜像包含 MCP 服务以及 file、git、binutils、nmap、curl 和 Python。主机上安装的工具在虚拟机内不可见，check_installed 和各顾问工具报告的是虚拟机中的工具。请改为将配置文件烘焙到镜像中，并在拉取服务更新后重新构建，因为镜像中包含服务的独立副本：

  make sandbox-image TOOLKIT_PROFILE=ctf
  

• 文件： 除非 CYBERSEC_SANDBOX_WORKSPACE 指定一个绝对目录，否则虚拟机看不到任何主机路径；指定后，该目录会映射为 /workspace（设置 CYBERSEC_SANDBOX_WORKSPACE_RO=1 时为只读）。向 run_tool 传入虚拟机内的路径。

• 网络： 虚拟机使用 Docker 默认网桥。设置 CYBERSEC_SANDBOX_NETWORK=none 可进行离线分析，也可以使用经过筛选的 Docker 网络来限制出站流量。

• 权限： 默认使用 uid 10001，移除所有 capabilities，启用 no-new-privileges，并限制为 2 GB 内存、2 个 vCPU 和 512 个进程。沙箱中无法进行原始套接字扫描（nmap -sS、-sU、操作系统检测）：虚拟机用户没有特权，且已设置 no-new-privileges，因此即使添加 NET_RAW capability 也不会生效。请使用 connect 扫描（-sT）或 --local 模式。

• 仅主机模式： 通过 SSH 远程执行（manage_remote_hosts），以及在主机上创建的 ~/.ctf-venvs/ 下的 venv。

• 审计： 审计记录通过 stderr 侧信道离开虚拟机，并追加到主机日志，因此虚拟机销毁后仍会保留记录。

客户端设置

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"
      }
    }
  }
}

登录 shell（bash -lc）会从配置文件中获取 node 和 uv，因此配置文件脚本不得向 stdout 输出内容，因为 stdout 承载 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，并且需要支持 MCP 的端点，例如 /api/v1/chat 或 /v1/responses。
• Ollama 和其他本地模型：模型运行时不支持 MCP。请在其前面使用支持 MCP 的主机（OpenCode、Hermes、OpenClaw、Kit、LM Studio、Cline、Continue、Goose，或通过 MCP→OpenAPI 桥接工具（例如 mcpo）连接的 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 允许 Agent 编写并运行 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 会创建 ~/.ctf-venvs/crypto，其中包含 pycryptodome、sympy、gmpy2、numpy、z3、fpylll（以及 fpylll 在导入时需要、但未声明依赖的 cysignals）和 cypari2，这样 Agent 就可以调用 run_script(code, venv="crypto")。在沙箱中，venv 使用来宾系统路径：使用 TOOLKIT_PROFILE=ctf 构建镜像即可获得 crypto。有些软件包需要较旧版本的 Python，例如 pwntools：

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。

Agent 为你编写的可复用辅助工具（漏洞利用脚本、多步骤求解器、解析器、协议辅助工具）会保存在 manual_scripts/ 下。在协作模式中，Agent 会提出脚本，并仅在你批准后运行；在 autonomous 模式中，当工具和工作流无法继续取得进展时，Agent 会编写并运行范围受限的辅助工具。普通侦察和 HTTP 请求仍通过 run_tool 调用。

测试服务

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

这会打开 MCP Inspector，以便交互式试用各项工具。mcp_server/README.md 介绍了 Claude Desktop 的设置方法以及完整的服务参考文档。

Agent 技能

.claude/skills/ 中有 872 项 Agent 技能，这是 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、供应链／产品安全）
• 6 项 CTF 方法论技能（ctf-crypto、ctf-pwn、ctf-web、ctf-rev、ctf-forensics、ctf-stego）和 4 项漏洞赏金方法论技能（bounty-recon、bounty-web、bounty-api、bounty-mobile）
• 754 项实操指南，来自 mukul975/Anthropic-Cybersecurity-Skills（Apache 2.0）
• 58 项攻击方法论技能，来自 SnailSploit Claude-Red（MIT）
• 14 项代码审计技能，来自 Trail of Bits（CC-BY-SA 4.0）
• 10 项漏洞赏金工作流技能，来自 BugHunter (claude-bug-bounty)（MIT）
• 4 项高层级工作流，来自 Transilience（MIT）
• 1 项编码 Agent 工作流技能，来自 multica-ai/andrej-karpathy-skills（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 均通过各自的路径支持 Agent 技能。对于读取该位置的客户端，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 上运行 shell 测试：原生 Windows 工作区可能会将 Bats 子模块改写为 CRLF，导致 $'\r' 错误。

每个版本的发布说明（包括安全修复和升级步骤）都在 GitHub Releases 页面；git log $(git describe --tags --abbrev=0).. 会显示自最新版本以来合入的内容。

Star 历史

许可证

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。