pentest-tools – Security skill for AI agents

> ⚠️ AUTHORIZED USE ONLY

> This skill is for educational purposes or authorized security assessments only.

> You must have explicit, written permission from the system owner before using this tool.

> Misuse of this tool is illegal and strictly prohibited.

> Mandatory confirmation gate

> Before running any command that probes, exploits, changes, persists on, extracts data from, or attempts credential access against a target:

> 1. Ask the user to state the exact target URL, IP, account, or resource.

> 2. Ask the user to confirm written authorization and the permitted scope.

> 3. Show the exact command(s) and explain their expected effect.

> 4. Wait for explicit confirmation in the current conversation.

>

> Without that confirmation, remain read-only and provide defensive guidance only. Prefer a sandbox, disposable VM, or controlled lab.

When to Use

• An authorized assessment needs standard tooling orchestrated coherently.
• Choosing and sequencing the right tool per recon/exploitation phase.

适用范围

当任务属于以下场景时使用本 skill：

• 目标信息收集（端口扫描、子域名枚举、服务识别）
• 漏洞扫描（Web 漏洞、CVE 检测、配置错误）
• Web 渗透（SQL 注入、XSS、SSRF、目录爆破）
• 密码破解（哈希破解、字典攻击）
• 网络渗透（服务利用、横向移动辅助）

与其他 skill 的分工

| 场景 | 用什么 |

|------|--------|

| 主动扫描/攻击（Nmap/Nuclei/SQLMap） | 本 skill |

| 逆向分析二进制 | ida-reverse/ 或 radare2/ |

| 前端 JS 签名逆向 | js-reverse/ |

| 浏览器/桌面自动化操作 | browser-automation/ |

| CTF 竞赛（综合） | CTF-Sandbox-Orchestrator/ |

简单判断：

• 需要"扫描目标、发现漏洞、利用漏洞" → 本 skill
• 需要"分析程序内部逻辑" → 逆向类 skill
• 需要"操作浏览器/桌面" → browser-automation

---

工具矩阵

信息收集

| 工具 | 用途 | 典型命令 |

|------|------|---------|

| Nmap | 端口扫描、服务识别、OS 检测 | nmap -sV -sC -O target |

| Masscan | 大规模快速端口扫描 | masscan -p1-65535 target --rate=1000 |

| Subfinder | 子域名枚举 | subfinder -d target.com |

| httpx | HTTP 探测、存活检测 | httpx -l urls.txt -status-code |

漏洞扫描

| 工具 | 用途 | 典型命令 |

|------|------|---------|

| Nuclei | 模板化漏洞扫描（CVE/配置/暴露） | nuclei -u target -t cves/ |

| ZAP | Web 应用安全扫描 | 通过 API 或 MCP 调用 |

| Nikto | Web 服务器漏洞扫描 | nikto -h target |

Web 渗透

| 工具 | 用途 | 典型命令 |

|------|------|---------|

| SQLMap | SQL 注入自动化 | sqlmap -u "url?id=1" --batch --dbs |

| FFUF | 目录/参数爆破 | ffuf -u target/FUZZ -w wordlist.txt |

| Gobuster | 目录/子域名爆破 | gobuster dir -u target -w wordlist |

| XSStrike | XSS 检测 | xsstrike -u "url?param=test" |

密码破解

| 工具 | 用途 | 典型命令 |

|------|------|---------|

| Hashcat | GPU 哈希破解 | hashcat -m 0 hash.txt wordlist.txt |

| John the Ripper | CPU 哈希破解 | john --wordlist=rockyou.txt hash.txt |

| Hydra | 在线暴力破解 | hydra -l admin -P pass.txt target ssh |

利用框架

| 工具 | 用途 | 说明 |

|------|------|------|

| Metasploit | 漏洞利用框架 | 需要单独安装，体量大 |

| Impacket | Windows 协议利用（SMB/WMI/Kerberos） | pip install impacket |

---

Catalog prerequisites

This tree supplies guidance, not the upstream router/bootstrap runtime. Paths such as skills/scripts/*.ps1, ops/scope-contract.md, tool-index, RULES, routing.md and field-journal/ refer to an external upstream installation. Do not run or claim those procedures unless the exact reviewed files exist. Bundled templates are under references/templates/; the suggested payloads/ and top-level templates/ directories are not bundled.

Historical tool counts, stars, report inventories and vendor comparisons below are upstream descriptions, not current verified capabilities or a guarantee that raw datasets are included. Inspect actual files and upstream versions before use. Bind tool-execution services to loopback, review authentication and permissions, and pin reviewed image/source versions before launch.

MCP 后端选择

本 skill 支持两种 MCP 后端，选一个即可：

方案 A：pentestMCP（推荐，Docker 一键）

• 项目：https://github.com/ramkansal/pentestmcp
• 特点：20+ 工具打包成单个 Docker 容器，MCP server 直接暴露
• 工具：Nmap、Nuclei、ZAP、SQLMap、FFUF、Nikto、Gobuster、Subfinder、httpx 等
• 安装：

# 拉取并运行
docker pull ramkansal/pentestmcp
docker run -d -p 127.0.0.1:8080:8080 ramkansal/pentestmcp

# 或本地构建
git clone https://github.com/ramkansal/pentestmcp.git
cd pentestmcp
docker build -t pentestmcp .
docker run -d -p 127.0.0.1:8080:8080 pentestmcp

• MCP 注册：

{
  "mcpServers": {
    "pentest": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

方案 B：mcp-security-hub（模块化）

• 项目：https://github.com/FuzzingLabs/mcp-security-hub
• 特点：每个工具独立 MCP server，按需启用
• 工具：Nmap、Ghidra、Nuclei、SQLMap、Hashcat
• 安装：按各子模块 README 操作

方案 C：单工具 MCP（最轻量）

如果只需要某一个工具：

| 工具 | MCP 项目 | 安装 |

|------|---------|------|

| Nmap | [nmap-mcp-server](https://github.com/PhialsBasement/nmap-mcp-server) | npm |

| Nuclei | [nuclei-mcp](https://github.com/addcontent/nuclei-mcp) | npm |

| SQLMap | mcp-security-hub 子模块 | pip |

Reqable MCP（本地抓包与 API 工作台）

Reqable 桌面客户端可通过官方 [Reqable MCP Server](https://github.com/reqable/reqable-mcp-server) 暴露本地抓包、API、断点和规则能力。先单独安装并启动 Reqable，再登记 MCP：

powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\bootstrap-reverse.ps1 -Capability reqable-mcp -McpHostTarget Codex

将 Codex 替换为 Claude 或 Both 可选择对应客户端；省略 -McpHostTarget 时不会写任何客户端全局配置。

登记后的 stdio 配置为：

{
  "mcpServers": {
    "reqable-mcp": {
      "command": "npx",
      "args": ["-y", "[email protected]", "--scope", "minimal"]
    }
  }
}

• 默认使用 Reqable 的本地 API；必要时按官方文档配置 --host、--port 或 --scope minimal|all。
• minimal 是推荐默认范围；all 会暴露更多会改变代理、规则、环境或已保存数据的工具。
• 对捕获流量、请求重放和规则修改仍须先满足 scope.md 的授权与网络限制；不得因 MCP 已注册而扩大目标范围。

---

工作流

标准渗透流程

> 重要：执行渗透测试时，必须按 references/pentest-loop.md 的自主循环框架运行。

> 该框架定义了完整的风险门控、记录规范、上下文压缩和完成检查机制。

1. 信息收集
   - Nmap 端口扫描 → 确认开放服务
   - Subfinder 子域名枚举 → 扩大攻击面
   - httpx 存活检测 → 过滤有效目标

2. 漏洞扫描
   - Nuclei 模板扫描 → 快速发现已知漏洞
   - ZAP/Nikto → Web 应用深度扫描

3. 漏洞利用
   - SQLMap → SQL 注入
   - FFUF → 发现隐藏路径/参数
   - 手动验证 → 确认可利用性

4. 后渗透（如果授权范围内）
   - 权限提升
   - 横向移动
   - 数据提取

5. 报告
   - 调用 docs-generator skill 生成渗透测试报告

快速扫描流程（5 分钟出结果）

1. nmap -sV -sC target → 端口+服务
2. nuclei -u target -severity critical,high → 高危漏洞
3. 有 Web 服务 → ffuf -u target/FUZZ -w common.txt → 目录
4. 汇总发现 → 决定下一步

---

注意事项

• 必须有授权 — 所有扫描/攻击操作必须在授权范围内
• 控制扫描速率 — 避免触发 WAF/IDS 或打崩目标
• 先被动后主动 — 先信息收集，再漏洞扫描，最后利用
• 记录所有操作 — 每个命令和结果都要记录，用于报告
• 不要盲目自动化 — AI 应该在每个关键步骤等待确认

---

按需自举（On-Demand Bootstrap）

自动化能力边界

| 工具 | 可自动安装 | 安装方式 | 说明 |

|------|-----------|---------|------|

| Nmap | ✓ | winget (Insecure.Nmap) | Windows 版 |

| Nuclei | ✓ | go install 或 GitHub Release | 需要 Go 或直接下载二进制 |

| SQLMap | ✓ | pip install sqlmap 或 git clone | Python |

| FFUF | ✓ | GitHub Release | Go 二进制 |

| SecLists | ✓ | GitHub Release ZIP | 字典大全（FFUF/Gobuster 必备） |

| Hashcat | ✗ | 手动下载 | 需要 GPU 驱动 |

| Metasploit | ✗ | 手动安装 | 体量大，建议用 Kali |

| pentestMCP (Docker) | ✗ | 需要 Docker | docker run ramkansal/pentestmcp |

| Impacket | ✓ | pip install impacket | Python |

| ProxyCat | ✓ | pip install proxycat | 代理池中间件（批量扫描防封） |

| BurpSuite MCP | ✗ | BurpSuite 扩展市场安装 | 需要 BurpSuite Pro/Community |

| Reqable MCP | ✓ | npx -y [email protected] | 需先手动安装 Reqable 桌面客户端 |

自举策略

1. 如果用户有 Docker → 推荐 pentestMCP（一键全家桶）

2. 如果没有 Docker → 按需单独安装各工具

3. 优先安装 Nmap + Nuclei + SQLMap（覆盖 80% 场景）

手动安装引导

⚠️ **渗透工具未安装**

**推荐方案（需要 Docker）**：
docker pull ramkansal/pentestmcp
docker run -d -p 127.0.0.1:8080:8080 ramkansal/pentestmcp

**轻量方案（逐个安装）**：
- Nmap: winget install Insecure.Nmap
- Nuclei: go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
- SQLMap: pip install sqlmap
- FFUF: 从 https://github.com/ffuf/ffuf/releases 下载

**安装后告诉我，我继续当前任务。**

---

参考资源

• [awesome-pentest](https://github.com/enaqx/awesome-pentest) — 25k+ stars 渗透工具大全
• [SecLists](https://github.com/danielmiessler/SecLists) — 字典/payload 集合（FFUF/Gobuster 必备）
• [PayloadsAllTheThings](https://github.com/swisskyrepo/PayloadsAllTheThings) — 各类漏洞 payload
• [HackTricks](https://book.hacktricks.wiki/) — 渗透技巧百科
• [pentest-ai-agents](https://github.com/0xSteph/pentest-ai-agents) — 35 个 Claude Code 渗透子 agent（参考其 prompt 模式）
• [Pentest Swarm AI](https://github.com/Armur-Ai/Pentest-Swarm-AI) — 群体智能自主渗透框架（多 agent 协同，支持 MCP server）
• [ProxyCat](https://github.com/honmashironeko/ProxyCat) — 代理池中间件（批量扫描防封 IP）
• [planning-with-files](https://github.com/othmanadi/planning-with-files) — 计划任务 skill（循环测试用）

本 skill 内参考文档

• references/pentest-loop.md — 核心循环框架（风险门控 + 记录规范 + 上下文压缩）
• references/recon-pipeline.md — 授权侦察流水线（CF 头 / nmap / Evidence）
• references/client-side-lab-playbook.md — DOM XSS / 原型污染 / agent-browser（靶场客户端面）
• references/burpsuite-mcp-guide.md — BurpSuite MCP 完整指南（63 工具 + 7 大使用场景 + AI Prompt 模板）
• references/automation-loop-pattern.md — 自动化循环测试模式（轻量版）
• references/awesome-pentest-digest.md — 渗透工具精华速查
• references/pentest-ai-agents-matrix.md — 35 agent 覆盖矩阵
• payloads/ — 自定义 payload 目录（AI 优先使用）
• templates/ — 渗透测试必需文件模板（scope/rules/plan/findings/progress）

#

… (full content is in the download package)