НЕ для образовательных целей: MCP-сервер для профессиональных пентестеров, включающий поддержку STDIO/HTTP/SSE, а также nmap, go/dirbuster, nikto, JtR, hashcat, создание wordlist и многое другое.
Pentest MCP — это MCP-сервер на TypeScript для авторизованных оценок безопасности. Он предоставляет исследователю-человеку или агенту оценки, использующему инструменты, единый ограниченный интерфейс для разведки, валидации, сбора данных, проверки учётных данных, локального аудита, получения доказательств и подготовки отчётов. Каждый активный вызов инструмента привязан к engagement и к долговременной записи. Сервер проверяет заявленные цели и временное окно; исследователь проверяет находки перед публикацией.
engagementId.allowedToolNames из плана разрешает только выбранные вызовы. Активные инструменты также проходят проверку цели engagement и временного окна.recordId и связанные решения по области действия с помощью listEngagementRecords и getEngagementRecord. Записи сохраняются между перезапусками. Импортируйте внешние исследования с помощью recordResearchActivity; импорт не заменяет использование инструментов MCP.getClientReport.Проверка заявленных целей — это операционный защитный барьер, а не полная сетевая граница. Изменения DNS, перенаправления, скрипты Nmap, шаблоны Nuclei и другое поведение сторонних инструментов могут создавать вторичный трафик. Проверяйте конфигурацию инструментов и поддерживайте сетевые средства контроля в соответствии с правилами engagement.
Этап оценки — это сессия агента, использующего инструменты. runAgentAssessment поддерживает локальный Codex или Claude в выделенном профиле учётной записи, Codex в закреплённом контейнере, loopback-сервер, совместимый с OpenAI, такой как llama.cpp или Ollama, а также OpenRouter. CLI-воркеры получают заблокированный сервер Pentest MCP для одного engagement и обнаруживают полный каталог. Защищённые API-модели получают только точный список разрешений из плана, пересечённый с каталогом воркера. Каждое запрошенное действие по-прежнему проходит те же проверки плана, цели, статуса родителя и времени на стороне воркера, прежде чем запускается обработчик. Необязательный hostileModelProtection добавляет предохранители для дублирующихся действий, учёта токенов и причин завершения и по умолчанию имеет значение false. Прерванный запуск с долговременной квитанцией о старте и без терминальной квитанции блокирует повтор; reconcileAgentAssessment требует, чтобы оператор подтвердил остановку предыдущего процесса, записывает проверяющего и обоснование и отзывает область действия предыдущего воркера, если она всё ещё доступна. Возвращаемые toolCounts, importedRecordIds и importMapRecordId идентифицируют записанные действия и импортированные доказательства. Запуск без успешного вызова инструмента оценки завершается неудачей.
draftAssessmentReport — это более поздний этап написания отчёта с изолированным контекстом; один лишь черновик не показывает, что Pentest MCP помог в оценке. OpenAI, Anthropic, OpenRouter, OpenAI-совместимые, локальный Codex, локальный Claude, контейнерный Codex и настроенные SSH-профили могут составлять черновик из ограниченного пакета доказательств без инструментов сканирования. local-agent принимает самостоятельно размещённые CLI-профили и OpenAI-совместимые профили с loopback-адресом, отклоняя хостинговые провайдеры до отправки контекста. Руководство по защищённым моделям содержит профили 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 запускает встроенный MCP Inspector для этого сервера через stdio; флаги Inspector можно передавать, например pentest-mcp inspector --help.
Задайте PENTEST_DATA_DIR, чтобы выбрать локальный каталог доказательств. В противном случае сервер использует $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, поддомены с подстановочными знаками и префиксы URL HTTP(S). Исключения имеют приоритет. Все временные метки требуют явного часового пояса. getEngagement и listEngagements проверяют сохранённые регистрации. closeEngagement отзывает последующее выполнение, прерывает управляемые оценки, выполняющиеся в том же процессе сервера, и заставляет отдельный управляемый runner остановиться, когда он обнаруживает закрытие родительского реестра.