pentest-tools

Pentest-Tools.com CLI & MCP サーバー

脆弱性を検査するプラットフォーム Pentest-Tools.com のコマンドラインインターフェース、Python バインディング、MCP サーバーです。Web アプリケーションとネットワークインフラをスキャンできます。

MCP サーバー

MCP に対応した AI アシスタントを Pentest-Tools.com アカウントに接続して、スキャンの実行、検出結果のトリアージ、レポートの生成ができます。有料プランの API キーが必要です。マイアカウント > 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=

または、使用するエージェントと設定ファイルの場所に応じて、手動で追加します。

{
  "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 引数を使用できます。

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