pentest-tools

Pentest-Tools.com CLI 和 MCP 服务

Pentest-Tools.com 的命令行界面、Python 绑定和 MCP 服务。Pentest-Tools.com 是一个用于扫描 Web 应用和网络基础设施漏洞的平台。

MCP 服务

将任何兼容 MCP 的 AI 助手连接到你的 Pentest-Tools.com 账户，以运行扫描、分类调查结果并生成报告。你需要付费套餐的 API 密钥。前往「My Account > API」获取密钥。

支持的客户端： Claude、Cursor、VS Code、Gemini CLI，以及任何兼容 MCP 的工具。 完整文档： pentest-tools.com/docs/ai/mcp/overview

你可以执行的操作

• 运行 Website Scanner、Subdomain Finder 和 Network Scanner 扫描
• 管理目标、工作区、扫描和调查结果
• 生成并下载报告，包括为区域团队翻译的报告
• 通过自然语言提示词，将工具串联成多阶段工作流，涵盖侦察、漏洞分类和执行摘要

快速设置：远程服务（推荐）

对于基于终端的客户端，可直接使用：

Claude Code

claude mcp add --transport http ptt-mcp https://mcp.pentest-tools.com/mcp --header "Authorization: Bearer your_api_key_here"

Gemini CLI

gemini mcp add ptt-mcp --transport http https://mcp.pentest-tools.com/mcp --header "Authorization: Bearer your_api_key_here"

Cursor： 在浏览器中粘贴此 URL 以一键安装，然后添加 API 密钥：

cursor://anysphere.cursor-deeplink/mcp/install?name=ptt-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5wZW50ZXN0LXRvb2xzLmNvbS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgeW91cl9hcGlfa2V5X2hlcmUifX0=

或者根据你偏好的 Agent 和配置文件位置手动添加：

{
  "servers": {
    "ptt-mcp": {
      "type": "http",
      "url": "https://mcp.pentest-tools.com/mcp",
      "headers": { "Authorization": "Bearer your_api_key_here" }
    }
  }
}

本地服务

需要 Python 3.10+。

pip install "pentesttools[mcp]"
PTT_API_KEY=your_api_key_here ptt mcp

你也可以直接传入密钥：--key your_api_key_here。有关客户端专属的本地设置，请参阅完整文档。

CLI

在终端中运行扫描，或将 PTT 集成到脚本和 CI/CD 流水线中。

有关 AI 助手集成，请参阅上面的 MCP 服务部分。

安装

PentestTools Python 模块通过 PyPI 发布，因此可以直接通过 pip 安装：

pip install pentesttools

用法

pentesttools 包通过 ptt 实用程序提供命令行界面。 目前，它支持 Website Scanner 服务。

最简单扫描的示例：

ptt run website_scanner <url>

此命令会对 <url> 运行免费增值版 Website Scanner 扫描。与平台本身不同，你可以省略 URL 中的协议部分。

全局参数（例如深度扫描所需的密钥）必须直接传给 ptt。工具参数则必须传给工具。

ptt --key <key> run website_scanner --scan_type deep <url>

如果希望报告中包含风险高于某个值的漏洞时命令失败，可以使用 --fail argument。

ptt --fail high run website_scanner <url>

你也可以通过 docker 运行 ptt。docker 镜像将 ptt 设为入口点，因此无需再输入它。请注意，docker 中仍使用旧名称 ptt-scan。

docker run pentesttoolscom/ptt-scan:latest run website_scanner <url>

开发安装

如果你想轻松修改源代码及你的修改：

pip install --edit .

卸载

pip uninstall pentesttools

测试和覆盖率

你可以按如下方式运行测试并生成覆盖率报告：

python3 -m pytest src/tests

coverage run -m pytest src/tests
coverage report -m