教育的な目的ではありません:プロのペネトレーションテスター向けのMCPサーバー。STDIO/HTTP/SSEサポート、nmap、go/dirbuster、nikto、JtR、hashcat、ワードリストの構築などを含みます。
Pentest MCP は、許可されたセキュリティ評価のための TypeScript 製 MCP サーバーです。人間の研究者、またはツールを利用する評価エージェントに対して、ディスカバリ、検証、キャプチャ、認証情報チェック、ローカル監査、証拠取得、レポート作成のための単一のスコープ付きインターフェースを提供します。アクティブなツール呼び出しはそれぞれ、エンゲージメントと永続的な記録に紐付けられます。サーバーは宣言されたターゲットと時間枠をチェックし、研究者は公開前に発見事項を検証します。
engagementId を選択します。allowedToolNames リストによって選択された呼び出しのみが許可されます。アクティブなツールはさらに、エンゲージメントのターゲットと時間ゲートを通過する必要があります。listEngagementRecords と getEngagementRecord を使用して、recordId の値と相関するスコープ決定を確認します。記録は再起動後も保持されます。recordResearchActivity で外部リサーチをインポートします。このインポートは MCP ツールの使用を置き換えるものではありません。getClientReport を使用して Markdown または JSON を取得します。宣言されたターゲットのチェックは運用上のガードレールであり、完全なネットワーク境界ではありません。DNS の変更、リダイレクト、Nmap スクリプト、Nuclei テンプレート、その他のサードパーティツールの動作によって二次的なトラフィックが発生する可能性があります。ツールの設定を確認し、ネットワーク制御をエンゲージメントのルールと整合させてください。
評価ステージはツールを利用するエージェントセッションです。runAgentAssessment は、専用のアカウントプロファイル内のローカル Codex または Claude、固定コンテナ内の Codex、llama.cpp や Ollama などのループバック OpenAI 互換サーバー、および OpenRouter をサポートします。CLI ワーカーは、単一エンゲージメントにロックされた Pentest MCP サーバーを受け取り、完全なカタログを検出します。ガード付き API モデルは、計画の許可リストとワーカーカタログの積集合のみを受け取ります。要求されたすべてのアクションは、ハンドラーが開始される前に、ワーカー側の同じ計画、ターゲット、親ステータス、時間のチェックに到達します。オプションの hostileModelProtection は、重複アクション、トークン会計、終了理由のサーキットブレーカーを追加し、デフォルトは false です。永続的な開始レシートがあり、終端レシートがない中断された実行はリプレイをブロックします。reconcileAgentAssessment は、オペレーターが以前のプロセスが停止したことを確認することを要求し、レビュアーと根拠を記録し、以前のワーカースコープがまだ利用可能な場合はそれを取り消します。返される toolCounts、importedRecordIds、importMapRecordId は、記録されたアクションとインポートされた証拠を識別します。評価ツールの呼び出しが一度も成功しなかった実行は失敗します。
draftAssessmentReport は、コンテキストを隔離した後段のレポート作成ステップです。ドラフト単体では、Pentest MCP が評価に役立ったことを示すことはできません。OpenAI、Anthropic、OpenRouter、OpenAI 互換、ローカル Codex、ローカル Claude、コンテナ Codex、および設定済みの SSH プロファイルは、スキャナーツールなしで、範囲を限定した証拠パケットからドラフトを作成できます。local-agent はセルフホスト型 CLI プロファイルとループバックの OpenAI 互換プロファイルを受け入れますが、ホスト型プロバイダーはコンテキストが送信される前に拒否します。ガード付きモデルガイドでは、llama.cpp と OpenRouter のプロファイル、強制される停止条件、監査フィールド、および敵対的モデルのデプロイ境界について説明しています。コンテナ評価ガイドでは、CLI プロファイルのフィールド、実際の受け入れコマンド、および分離の制限について説明しています。エージェント型ワークフローでは、スコープ、証拠レビュー、Daybreak/Glasswing へのアクセス、および Faxbot の計画について扱っています。
リリースの受け入れには scripts/run-real-acceptance.mjs を使用します。これにはデフォルトのターゲットや認可がなく、インストール済みの Nmap と ProjectDiscovery HTTPX が成功した証拠レコードを作成しない限り合格を拒否します。--profile を指定すると、管理対象エージェントは Pentest MCP を介して両方を呼び出す必要があります。--report-profile を指定すると、別個のレポートコンテキストが保存済みドラフトを生成する必要があります。テストダブルは自動テスト内にのみ残り、受け入れレシートとして出荷されることは決してありません。
Node.js 22.19.0 以降、および使用予定のツールに対応するホストバイナリが必要です。Docker イメージには記載のツールが含まれていますが、ネイティブインストールではこれらを PATH に用意する必要があります。
npm install -g pentest-mcp
pentest-mcp
Stdio はローカル MCP クライアントのデフォルトです。pentest-mcp inspector は、このサーバーに対して stdio 経由でバンドルされた MCP Inspector を起動します。Inspector のフラグは転送できます。例えば pentest-mcp inspector --help のように指定します。
ローカルのエビデンスディレクトリを選択するには PENTEST_DATA_DIR を設定します。設定しない場合、サーバーは $XDG_DATA_HOME が設定されていれば $XDG_DATA_HOME/pentest-mcp を、そうでなければ ~/.pentest-mcp を使用します。エビデンスとレポートのファイルは、プライベートなディレクトリおよびファイル権限で保存されます。生の出力、ハッシュ、キャプチャしたトラフィック、レポートはクライアントの機密データとして扱い、それに応じてアクセス、保持、バックアップを管理してください。
スキャンの前に createEngagement を呼び出します。実際に署名された認可に基づく日付、ターゲット、参照を使用してください。以下の値は例示です。
{
"tool": "createEngagement",
"arguments": {
"engagementId": "client-2026-10",
"authorizationReference": "Signed SoW section 4, approved 2026-10-24",
"notBefore": "2026-10-25T09:00:00-06:00",
"expiresAt": "2026-10-26T18:00:00-06:00",
"allowedTargets": ["app.example.com", "192.0.2.0/28"],
"excludedTargets": ["192.0.2.7"],
"testingWindows": [
{
"start": "2026-10-25T09:00:00-06:00",
"end": "2026-10-25T17:00:00-06:00"
}
]
}
}
許可されたターゲットは、完全一致のホスト、CIDR、ワイルドカードサブドメイン、およびHTTP(S) URLプレフィックスを受け付けます。除外設定が優先されます。すべてのタイムスタンプには明示的なタイムゾーンが必要です。getEngagement と listEngagements は保存された登録情報を検査します。closeEngagement は以降の実行を取り消し、同じサーバープロセスで実行中の管理対象アセスメントを中止し、別個の管理対象ランナーが親レジストリのクローズを検知した時点でそのランナーを停止させます。
アクティブなツールには同じ engagementId を使用してください。デフォルトの非rootコンテナはTCPコネクトスキャンをサポートしますが、SYNおよびOS検出にはデフォルトでは付与されない追加の権限が必要です。
{
"tool": "nmapScan",
"arguments": {
"engagementId": "client-2026-10",
"target": "app.example.com",
"scanTechnique": "Connect",
"serviceVersionDetection": true
}
}
ツールの応答が成功すると、保存された証拠の recordId が含まれます。必要なレコードだけを取得してください:
{
"tool": "listEngagementRecords",
"arguments": {
"engagementId": "client-2026-10",
"limit": 50
}
}
listEngagementRecords はサマリーを返し、古いレコードをページングするための limit と offset を受け付けます。getEngagementRecord は engagementId と recordId の両方を受け取り、許可されている場合に保存された証拠を返します。認証情報ツールは件数と出力ダイジェストを返します。新規の未認証 Gobuster/Nikto レコードは、所有者スコープの読み取り用にプライベートなスキャナー出力と検出結果を保持します。古いスキャナーレコードは引き続き秘匿化されます。Nmap XML と制限付きの ffuf/Nuclei マシン出力はサマリーとともに保持されます。レコードの outcome は succeeded、failed、または cancelled であり、追跡されている場合は開始時刻と所要時間が付きます。サブプロセスの失敗は、スキャン成功結果ではなく監査レコードを作成します。プリフライトのスコープ拒否ではコマンドは開始されません。認証済み HTTP の場合、エンゲージメントと証拠へのアクセスは検証済みトークン所有者にスコープされ、stdio データはサーバーインストールに対してローカルです。
saveAssessmentPlan は、目的、人間が読める形式の許可および禁止メソッド、正確な allowedToolNames、データ処理、停止条件、レポート対象者、作業の所有権、およびモデルデータポリシーを、バージョン管理された証拠レコードとして保存します。getAssessmentPlan は最新バージョンを読み取ります。マネージドワーカーは完全なカタログを受け取りますが、サーバーは allowedToolNames から省略された呼び出しをハンドラー実行前に拒否し、失敗した監査レシートを残します。計画が存在する場合、その許可リストは 14 のアセスメントメソッドへの直接の手動 MCP 呼び出しもゲートし、拒否はハンドラーまたはコマンドの実行前に監査されます。計画のないレガシーエンゲージメントへの直接呼び出しは以前の動作を維持し、引き続きエンゲージメントスコープのゲートを通過します。この計画は createEngagement のターゲットや時間を拡張することはできません。外部クライアントの計画では、モデルによるドラフト作成の前にプロバイダーのクライアント作業承認参照が必要であり、no-model は決定論的ドラフトのみを許可します。計画スキーマと例を参照してください。
modelDataPolicy: "local-agent" または "approved-provider" かつ空でない allowedToolNames を持つ計画が記録された後、ツールを使用する実行を起動します:
{
"tool": "runAgentAssessment",
"arguments": {
"engagementId": "client-2026-10",
"profileId": "daybreak-cli-assessment",
"timeoutSeconds": 900
}
}
レスポンスには、実行ID、ステータス、モデル、toolCounts、インポートされたエビデンスID、importMapRecordId、および未レビューのモデル出力のIDが含まれます。モデル、MCP子プロセス、または評価ツールが失敗した場合は、再試行する前に、保持されている失敗情報とインポートされたレコードを確認してください。プロセスの中断後に開始レシートのみが存在する場合は、古いプロセスが停止したことを確認し、その実行ID、レビュアーID、および判断理由を指定してreconcileAgentAssessmentを呼び出してください。サーバーは実行を暗黙的に再生しません。評価ツールの呼び出しに成功せずに終了したプロセスは拒否されます。その制限付き出力は、診断用に失敗した結果とリンクされたハッシュとともに非公開で保持され、検証済みの検出事項のエビデンスとして扱われることは決してありません。エージェントプロセスが完了したからといって、その観察結果が確認済みの検出事項になるわけではありません。ワーカーは、エンゲージメントの作成、クローズ、計画の変更、再帰的な評価の起動、照合、およびレポートの公開をブロックします。