Pentester-MCP 是面向 AI 助手的安全测试 MCP 集成,把 200 多个开源渗透测试与网络安全工具封装为 MCP 服务,让 Claude Desktop、Cursor 等客户端可以自主调用 nmap、sqlmap、ffuf、gobuster、nuclei、impacket、hydra 等工具。每个工具都带有面向 AI 优化的文档、参数安全处理、超时限制和输出截断,以降低 shell 注入和系统污染风险。
安装推荐使用 Docker 沙箱,可隔离全部工具、避免污染宿主机:先克隆仓库 git clone https://github.com/halilkirazkaya/pentester-mcp.git 并进入目录,在 configs/example-config.yaml 中按需把工具设为 true/false,然后执行 docker compose up -d --build,用 docker ps | grep pentester-mcp 验证。本地执行适合 Kali Linux、Parrot OS 或已预装工具的系统,需 python3 -m venv .venv、source .venv/bin/activate、pip install -r requirements.txt。
配置分两部分:在 configs/example-config.yaml 中启用或禁用侦察、Web 利用、网络与 AD、密码等类别的工具;在客户端侧,Claude Desktop 的 claude_desktop_config.json 或 Cursor 的 MCP 设置中加入以 docker exec -i pentester-mcp /app/.venv/bin/python /app/server.py 启动的服务,本地执行则改为指向本机 python 与 server.py。项目采用单一统一服务器 server.py,按配置动态加载启用的工具模块,而非注册两百多个独立服务。
主要能力包括:侦察类如 nmap、masscan、amass、subfinder、nuclei;Web 利用类如 sqlmap、ffuf、gobuster、nikto、dirsearch;网络与 AD 类如 impacket、responder、evil_winrm、bloodhound;密码类如 hydra、john、hashcat。AI 可串接这些工具,例如先扫描端口,再对开放 Web 端口做目录爆破,再对发现的参数做注入测试。凭证应通过环境变量传入,不要硬编码。所有工具输出默认截断至 8000 字符;需要完整输出可在容器内直接执行命令。长任务可调大 timeout 参数。
限制与注意事项:本地执行时部分工具需要 root,可能涉及 sudo 配置;容器未启动、工具未启用或超时都可能报错,可通过 docker ps、docker logs 与重建容器排查。资料未提供收费、价格、平台支持范围等信息。仅可在自己拥有或已获明确书面授权的系统上使用,用于授权安全评估、有范围的漏洞赏金项目、教学实验环境或自有基础设施测试;未经授权的渗透测试违法。