Обзор

MCPwner — это сервер протокола контекста модели (MCP), который интегрирует инструменты тестирования безопасности в рабочие процессы на основе LLM. Он предоставляет единый интерфейс для сканирования секретов, статического анализа (SAST), анализа состава программного обеспечения (SCA), безопасности инфраструктуры как кода (IaC), фаззинга исходного кода, разведки, динамического тестирования безопасности приложений (DAST) и исследования уязвимостей, включая поиск 0-day.

Вместо ручного объединения инструментов и вставки результатов в вашу LLM, MCPwner стандартизирует и передаёт результаты непосредственно в рабочий контекст модели. Это обеспечивает непрерывное рассуждение, корреляцию и обнаружение путей атак на всём протяжении жизненного цикла исследования безопасности — от картирования поверхностей атак и выявления известных уязвимостей до обнаружения новых векторов атак.

Примечание: Этот проект находится в активной разработке. Узнайте больше о MCP здесь.

Интегрированные инструменты

Будущие инструменты

Следующие инструменты запланированы для будущих выпусков.

Небезопасная десериализация

Генераторы гаджет-цепочек и полезных нагрузок для использования недостатков десериализации, выявленных в ходе SAST. Зрелые экосистемы гаджет-цепочек существуют для Java, .NET и PHP; Python охвачен генерацией вредоносных pickle-файлов (десериализация Ruby/Node основана на полезных нагрузках и находится в корпусе полезных нагрузок ниже):

• ysoserial - Java
• ysoserial.net - .NET
• PHPGGC - PHP
• marshalsec - JVM-маршаллеры/анмаршаллеры
• Fickling - Python (pickle)

Контрабанда HTTP-запросов

• smuggler - Контрабанда/десинхронизация HTTP/1.1 (CL.TE, TE.CL, TE.TE)
• h2csmuggler - Контрабанда при обновлении до HTTP/2 по открытому тексту (h2c) (отличается от десинхронизации HTTP/2)
• http2smugl - Контрабанда/десинхронизация HTTP/2

Полезные нагрузки

Курированные корпуса полезных нагрузок и списков слов для поддержки вышеуказанных инструментов:

• SecLists - агрегация полезных нагрузок для фаззинга, учётных данных и списков инъекций
• PayloadsAllTheThings - атакующие полезные нагрузки и обходные пути, сгруппированные по классам уязвимостей
• FuzzDB - примитивы для внедрения ошибок и предсказуемые шаблоны ресурсов

Примеры использования

Автоматизированный конвейер перечисления```

"Enumerate and scan example.com" → MCPwner chains: Subfinder + Amass → Masscan + Nmap → httpx → Katana + gau → ffuf + Arjun

Аудит безопасности```

"Run a security audit on my Python project" → MCPwner runs Bandit (SAST), OSV-Scanner (SCA), and secrets scanning

Эксплуатация активной цели```

"Test for SQLi and XSS on http://localhost:8080" → MCPwner chains: sqlmap + Dalfox and verifies findings

2. Настройте сервер: ```bash cp config/config.yaml.example config/config.yaml

   Edit config/config.yaml as needed

   root@kitploit:~

3. Запустите сервисы: ```bash docker-compose up -d --build
   root@kitploit:~

4. Проверьте, что службы запущены: ```bash docker-compose ps
   root@kitploit:~

Подключите вашу IDE

После запуска контейнеров Docker добавьте MCPwner в ваш MCP-клиент:

Важно: динамическая регистрация инструментов MCPwner использует модульную архитектуру с явным согласием. За безопасные инструменты отвечают profiles Docker Compose.

1. Файл .env (COMPOSE_PROFILES=sast,secrets,reconnaissance,dast,etc) определяет, какие контейнеры будут запущены. В качестве альтернативы вы можете изменить это и запустить определённые профили через CLI: docker compose --profile sast --profile dast up -d.
2. MCP-сервер динамически проверяет запущенные контейнеры при старте и регистрирует только исправные инструменты в вашей LLM.
3. Если вы хотите исключить определённые инструменты (например, semgrep), удалите его категорию (sast) из .env и вручную перечислите нужные вам инструменты (bandit,gosec,codeql).
4. Примечание: Инструменты из категории utilities (например, Linguist, WireMock, Chromium) считаются постоянными основными зависимостями. Они запускаются безусловно при docker compose up -d, чтобы критически важные меж-инструментальные зависимости (например, определение языка) всегда работали.

Расположение файлов конфигурации:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Cursor/Kiro: mcp.json в вашем проекте или каталоге настроек

Установка в один клик (требуется запущенный Docker):

Ручная настройка:

Добавьте следующее в ваш файл конфигурации MCP:```json { "mcpServers": { "mcpwner": { "command": "docker", "args": ["exec", "-i", "mcpwner-server", "python", "src/server.py"], "env": {} } } }

Затем используйте инструмент create_workspace с:

• source_type="local"
• source="/mnt/projects/my-project"

Сохранение данных

MCPwner автоматически сохраняет метаданные рабочей области и базы данных CodeQL при перезапусках контейнера, используя файловое хранилище в общем томе Docker (/workspaces/.metadata/). Конфигурация не требуется — система загружает существующие данные при запуске и сохраняет после каждой операции, используя атомарные записи для предотвращения повреждения.

Управление очисткой рабочей области:

Инструмент cleanup_workspace обеспечивает детальный контроль:

• delete_files=True, delete_metadata=False - Освободить место на диске, но сохранить историю рабочей области (рекомендуется)
• delete_files=True, delete_metadata=True - Полное удаление рабочей области и метаданных
• delete_files=False, delete_metadata=True - Удалить из списка, но оставить файлы на диске

Резервное копирование:```bash

Backup entire workspaces volume

docker run --rm -v mcpwner_workspaces:/data -v $(pwd):/backup
alpine tar czf /backup/workspaces-backup.tar.gz /data

Restore volume

docker run --rm -v mcpwner_workspaces:/data -v $(pwd):/backup
alpine tar xzf /backup/workspaces-backup.tar.gz -C /

Доступные инструменты MCP

MCPwner предоставляет следующие инструменты через интерфейс MCP:

Управление рабочими пространствами:

• create_workspace — инициализация рабочего пространства сканирования из локального пути, Git-URL или репозитория GitHub
• list_workspaces — список всех доступных рабочих пространств
• cleanup_workspace — удаление рабочего пространства и связанных с ним данных

Журнал находок:

Область действия — рабочее пространство, сохраняется на диск (<workspace>/findings/<id>.json) и всегда доступен — без необходимости в контейнере или проверке работоспособности. Это источник истины для многопроцессорного конвейера глубокого исследования: каждая гипотеза, результат PoC и заключение проверки представляют собой запись находки, а не прозу.

• upsert_finding — создание или обновление находки. По умолчанию выполняет глубокое слияние с существующей записью, так что один агент может записать свой собственный подобъект (например, poc), не затирая поля другого агента (например, review)
• list_findings — список всех находок в рабочем пространстве, опционально отфильтрованных по status (например, poc-confirmed, review-approved)
• get_finding — получение одной находки по идентификатору

SAST (Статический анализ):

• run_sast_scan — запуск инструментов статического анализа (Semgrep, Bandit, Gosec, Brakeman, PMD, Psalm, NodeJsScan, Joern, YASA)
• get_sast_report — получение результатов SAST-сканирования
• sast_list_tools — список доступных SAST-инструментов

Обнаружение секретов:

• run_secrets_scan — запуск инструментов сканирования секретов (Gitleaks, TruffleHog, Whispers, detect-secrets, Hawk-Eye)
• get_secrets_report — получение результатов сканирования секретов
• secrets_list_tools — список доступных инструментов сканирования секретов

SCA (Анализ состава программного обеспечения):

• run_sca_scan — анализ зависимостей на наличие уязвимостей (Grype, Syft, OSV-Scanner, Retire.js)
• get_sca_report — получение результатов SCA-сканирования
• sca_list_tools — список доступных SCA-инструментов

Рекогносцировка:

• run_reconnaissance_scan — запуск одного инструмента рекогносцировки (Subfinder, Amass, Nmap, Masscan, httpx, Katana, ffuf, bbot, gau, Arjun, wafw00f, Kiterunner)
• run_reconnaissance_chain — последовательное выполнение нескольких инструментов рекогносцировки
• get_reconnaissance_report — получение результатов рекогносцировки
• reconnaissance_list_tools — список доступных инструментов рекогносцировки

CodeQL:

• detect_languages — определение языков в кодовой базе с помощью Linguist
• create_codeql_database — создание базы данных CodeQL для анализа
• list_databases — список доступных баз данных CodeQL
• list_query_packs — список доступных пакетов запросов
• execute_query — выполнение конкретных запросов CodeQL

Безопасность инфраструктуры и IaC:

• run_iac_scan — сканирование инфраструктуры как кода на предмет неверных конфигураций (Checkov, KICS, Terrascan, TFSec, Hadolint)
• get_iac_report — получение результатов IaC-сканирования
• iac_list_tools — список доступных инструментов сканирования IaC

Фаззинг исходного кода:

• run_fuzzing_scan — запуск кампании белого ящика с фаззингом, управляемым покрытием, против целевой обвязки (Atheris, Jazzer, Jazzer.js, PHP-Fuzzer)
• get_fuzzing_report — получение результатов краш-тестов фаззинга (краш-входные данные + стек вызовов)
• fuzzing_list_tools — список доступных движков фаззинга, отфильтрованных по обнаруженному языку

DAST (Динамическое тестирование безопасности приложений):

• run_dast_scan — запуск инструментов динамического тестирования безопасности приложений (sqlmap, NoSQLMap, Commix, Dalfox, SSTImap, SSRFmap, jwt_tool, interactsh)
• get_dast_report — получение результатов DAST-сканирования
• dast_list_tools — список доступных DAST-инструментов

Утилиты:

• run_utilities_scan — запуск утилиты против живой цели (Linguist, WireMock, Mitmproxy, aiohttp, Headless Chromium)
• get_utilities_report — получение результатов сканирования утилитами
• utilities_list_tools — список доступных утилит и их параметров конфигурации

Мониторинг и проверка работоспособности:

• health_check — проверка доступности сервера и инструментов
• list_tools — список всех доступных инструментов и их статус

Соображения безопасности

MCPwner выполняет инструменты безопасности, которые могут выполнять интрузивные операции. Используйте только в системах и кодовых базах, которыми вы владеете или на которые имеете явное разрешение на тестирование — несанкционированный доступ незаконен. Ограничьте доступ к MCP-серверу только авторизованными пользователями и рассмотрите возможность сетевой изоляции для производственных развертываний. Просматривайте конфигурации инструментов перед запуском сканирования, так как некоторые инструменты могут генерировать значительный сетевой трафик или нагрузку на систему. Ведите журнал выполнения инструментов и результатов, помня, что сканирования безопасности могут вызывать срабатывания в системах мониторинга. Соблюдайте практику ответственного раскрытия информации при сообщении об уязвимостях, обнаруженных с помощью MCPwner. Регулярно обновляйте Docker-образы и сканируйте контейнеры на уязвимости. Никогда не сохраняйте ключи API, токены или учетные данные в файлах конфигурации — используйте переменные окружения или системы управления секретами.

Кроме того, вы должны сами отвечать за свою безопасность при запуске этих инструментов и доступе к сторонним библиотекам; рекомендуется запускать все в изолированной среде и без специальных прав доступа (минимизированной и защищенной, насколько это возможно).