在已授权范围内做主动渗透测试/漏洞扫描时，用 MCP 将…

适用于需要对授权目标进行信息收集、端口/漏洞扫描、Web 渗透、SQL 注入、目录爆破和密码破解，并通过 MCP 调用安全工具链的场景。

适用场景

解决思路

1. 先读取 ../field-journal/precedent-pentest.md，确认本 skill 的操作属于已授权的常规操作。
2. 确认 scope.md 存在且 auth.status=granted、network_profile 合法（参考 ../ops/scope-contract.md）；缺 scope 则运行 case-init.ps1 并停下等待用户授权，禁止自动加 -AuthGranted。
3. 确认当前任务命中本 skill 适用范围：目标信息收集、端口扫描、子域名枚举、服务识别、漏洞扫描、Web 渗透、SQL 注入、XSS、SSRF、目录爆破、密码破解、网络渗透辅助。
4. 进行路由判断：需要扫描目标、发现漏洞、利用漏洞时用本 skill；逆向分析二进制转 ida-reverse/ 或 radare2/；前端 JS 签名逆向转 js-reverse/；浏览器/桌面自动化转 browser-automation/；CTF 综合转 CTF-Sandbox-Orchestrator/。
5. 读取 ../tool-index.md，校验工具可用性和实际路径。
6. 缺工具时调用 bootstrap，不要猜路径。
7. 侦察阶段优先使用 references/recon-pipeline.md（CF 浏览器头 / Windows nmap / curl --globoff）；每批结果追加到 timeline.md；候选用 ../scripts/append-evidence.ps1 写入 Evidence，注意命中不等于已验证。
8. 现代 Web/靶场客户端面（DOM XSS / 原型污染 / agent-browser）使用 references/client-side-lab-playbook.md；即使未打穿也要写 observed Evidence 和失败门闩。
9. 信息收集：用 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。
10. 漏洞扫描：用 Nuclei 做模板化漏洞扫描（CVE/配置/暴露）：nuclei -u target -t cves/；用 ZAP 做 Web 应用安全扫描，通过 API 或 MCP 调用；用 Nikto 做 Web 服务器漏洞扫描：nikto -h target。
11. 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"。
12. 密码破解：用 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。
13. 利用框架：Metasploit 作为漏洞利用框架需单独安装，体量大；Impacket 用于 Windows 协议利用（SMB/WMI/Kerberos），安装命令 pip install impacket。
14. MCP 后端方案 A（推荐，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 8080:8080 ramkansal/pentestmcp；或本地构建：git clone https://github.com/ramkansal/pentestmcp.git；cd pentestmcp；docker build -t pentestmcp .；docker run -d -p 8080:8080 pentestmcp；MCP 注册：{"mcpServers":{"pentest":{"url":"http://localhost:8080/mcp"}}}。
15. MCP 后端方案 B：mcp-security-hub（模块化），项目 https://github.com/FuzzingLabs/mcp-security-hub，每个工具独立 MCP server，按需启用；工具包含 Nmap、Ghidra、Nuclei、SQLMap、Hashcat；安装按各子模块 README 操作。
16. MCP 后端方案 C：单工具 MCP（最轻量）；Nmap 用 nmap-mcp-server（npm）；Nuclei 用 nuclei-mcp（npm）；SQLMap 用 mcp-security-hub 子模块（pip）。
17. Reqable MCP（本地抓包与 API 工作台）：先单独安装并启动 Reqable，再登记 MCP；运行 powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\bootstrap-reverse.ps1 -Capability reqable-mcp -McpHostTarget Codex；将 Codex 替换为 Claude 或 Both 可选择对应客户端；省略 -McpHostTarget 时不写任何客户端全局配置。
18. Reqable MCP 的 stdio 配置为：{"mcpServers":{"reqable-mcp":{"command":"npx","args":["-y","reqable-mcp-server@1.0.1","--scope","minimal"]}}}；默认使用 Reqable 本地 API；必要时按官方文档配置 --host、--port 或 --scope minimal|all；minimal 是推荐默认范围，all 会暴露更多会改变代理、规则、环境或已保存数据的工具；对捕获流量、请求重放和规则修改仍须先满足 scope.md 的授权与网络限制，不得因 MCP 已注册而扩大目标范围。
19. 标准渗透流程必须按 references/pentest-loop.md 的自主循环框架运行；该框架定义完整的风险门控、记录规范、上下文压缩和完成检查机制。
20. 标准流程第 1 步信息收集：Nmap 端口扫描确认开放服务；Subfinder 子域名枚举扩大攻击面；httpx 存活检测过滤有效目标。
21. 标准流程第 2 步漏洞扫描：Nuclei 模板扫描快速发现已知漏洞；ZAP/Nikto 做 Web 应用深度扫描。
22. 标准流程第 3 步漏洞利用：SQLMap 做 SQL 注入；FFUF 发现隐藏路径/参数；手动验证确认可利用性。
23. 标准流程第 4 步后渗透（如果授权范围内）：权限提升、横向移动、数据提取。
24. 标准流程第 5 步报告：调用 docs-generator skill 生成渗透测试报告。
25. 快速扫描流程（5 分钟出结果）：nmap -sV -sC target 获取端口+服务；nuclei -u target -severity critical,high 查高危漏洞；有 Web 服务则 ffuf -u target/FUZZ -w common.txt 跑目录；汇总发现后决定下一步。
26. 注意事项：所有扫描/攻击操作必须有授权并在授权范围内；控制扫描速率避免触发 WAF/IDS 或打崩目标；先被动后主动，先信息收集再漏洞扫描最后利用；记录所有操作，每个命令和结果都要记录用于报告；不要盲目自动化，AI 应在每个关键步骤等待确认。
27. 按需自举能力边界：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 reqable-mcp-server@1.0.1，需先手动安装 Reqable 桌面客户端。
28. 自举策略：如果用户有 Docker，推荐 pentestMCP（一键全家桶）；如果没有 Docker，按需单独安装各工具；优先安装 Nmap + Nuclei + SQLMap（覆盖 80% 场景）。
29. 手动安装引导：未安装渗透工具时，推荐方案（需要 Docker）为 docker pull ramkansal/pentestmcp；docker run -d -p 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 下载；安装后告诉用户继续当前任务。
30. 需要扩展工具、字典、payload、技巧或 agent 参考时查阅：awesome-pentest（https://github.com/enaqx/awesome-pentest）、SecLists（https://github.com/danielmiessler/SecLists）、PayloadsAllTheThings（https://github.com/swisskyrepo/PayloadsAllTheThings）、HackTricks（https://book.hacktricks.wiki/）、pentest-ai-agents（https://github.com/0xSteph/pentest-ai-agents）、Pentest Swarm AI（https://github.com/Armur-Ai/Pentest-Swarm-AI）、ProxyCat（https://github.com/honmashironeko/ProxyCat）、planning-with-files（https://github.com/othmanadi/planning-with-files）。
31. 使用本 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）。
32. 使用 src-hunter/ 漏洞挖掘知识库：包含 19 类攻击 playbook（IDOR、RCE、XSS、SQLi、SSRF、OAuth、文件上传等）、305 个结构化 payload + 263 个 WAF/EDR 绕过步骤、2887 份 HackerOne 已披露 High/Critical 报告、88636 条 WooYun 历史案例统计、国产组件指纹和默认凭据、CVSS 4.0 报告模板；AI 在 hunt 阶段自动读取对应 playbook 并按流程测试；详见 src-hunter/SKILL.md 和 src-hunter/references/。
33. 路由上下文：上游入口为 skills/SKILL.md（总控）、routing.md；触发条件为需要主动扫描/攻击目标（端口扫描、漏洞检测、注入测试等）；下游出口为发现 Web 漏洞需进一步分析转 js-reverse/，发现二进制漏洞需逆向转 ida-reverse/ 或 radare2/，需要操作浏览器验证漏洞转 browser-automation/，完成后生成报告转 docs-generator/；同级关联模块为 CTF-Sandbox-Orchestrator/（CTF 中的 Web/Pwn 题会用到这些工具）。
34. 任务完成自检（声称完成前必须通过）：是否执行了工作流中的每一步而不是只阅读；是否基于 tool-index 使用了真实工具路径；是否产出可复现证据（命令/脚本/截图/报告）；是否完成并回写 RULES 要求的 Checklist 项。

适用边界 · 注意事项

• 未获得授权、scope.md 缺失、auth.status 不为 granted 或 network_profile 非法时，不应进行任何扫描/攻击操作。
• 任务是逆向分析二进制、前端 JS 签名逆向、浏览器/桌面自动化或 CTF 综合竞赛时，不应优先用本 skill，应转对应 skill。
• 没有 Docker/MCP 且无法完成工具自举时，不应猜测工具路径或盲目执行扫描。