mcp-shodan
MCP-сервер для Shodan и CVEDB: разведка по IP и поиск устройств, DNS и сведения об уязвимостях с EPSS и KEV
- 191 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запросы тратят платные кредиты Shodan, а HTTP-режим без авторизации открывает их любому
- Инструмент собирает сведения о сторонних хостах: используйте его на своих ресурсах или с разрешения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-shodanОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запросы тратят платные кредиты Shodan, а HTTP-режим без авторизации открывает их любому
- Инструмент собирает сведения о сторонних хостах: используйте его на своих ресурсах или с разрешения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту доступ к API Shodan и бесплатной базе CVEDB. По IP или имени хоста агент получает то, на что смотрит аналитик: открытые порты, продукты и версии, известные CVE, сведения о сертификате TLS (отпечаток, JARM, JA3S), облачного провайдера и историю баннеров. Поиск устройств идет на синтаксисе Shodan с постраничным выводом и разбивкой по странам, организациям, портам и уязвимостям, а режим подсчета бесплатно оценивает размер запроса. Есть DNS: поддомены, записи, прямой и обратный разбор списков. Одиннадцать инструментов только читают: `ip_lookup`, `shodan_search`, `shodan_count`, `domain_info`, `dns_lookup`, `reverse_dns_lookup`, `cve_lookup`, `cpe_lookup`, `cves_by_product`, `search_filters` и `api_info`. Для CVE выдаются CVSS v4, v3 и v2, EPSS и признак KEV, список по продукту сортируется по EPSS. Бесплатные инструменты помечены, а `api_info` показывает остаток кредитов. Транспорт stdio или HTTP streaming.
Для кого. Специалистам по безопасности и сетевым администраторам, которые проверяют собственные хосты и ищут сведения об уязвимостях через агента.
Подходит, если
- Нужно понять, что видно снаружи на адресе организации: порты, версии и сертификат
- Новая CVE вышла, и агент сверяет ее по CVSS, EPSS и признаку KEV
- Для продукта собирают список уязвимостей, отсортированный по вероятности эксплуатации
- Размер поискового запроса оценивают бесплатным подсчетом, прежде чем тратить кредиты
- Для списка адресов массово выполняют прямой и обратный DNS
Не подходит, если
- Нужно активное сканирование: сервер читает уже собранные данные Shodan и сам ничего не сканирует
- Нет ключа Shodan: часть инструментов, например CVEDB, бесплатна, но поиск и сведения об IP требуют ключа
- Нужны данные по чужим системам для вторжения: инструмент рассчитан на защиту и проверку своих ресурсов
Пример запроса к агенту
Что видно снаружи на 8.8.8.8 и входит ли CVE-2021-44228 в каталог KEVMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
SHODAN_API_KEYобязательная, секрет- Ключ API Shodan.
MCP_TRANSPORT- `stdio` или `httpStream`.
Ограничения
Нужны Node.js 20 или новее и собственный ключ Shodan, проект не связан с компанией Shodan. Запросы тратят кредиты плана: поиск с фильтрами стоит один кредит запроса плюс по одному за каждую следующую страницу, `domain_info` стоит один за вызов. Бесплатны `shodan_count`, `ip_lookup`, DNS-инструменты, `search_filters`, `api_info` и инструменты CVEDB. У режима HTTP нет авторизации: держите порт на localhost или за проксированием с авторизацией, иначе любой, кто достучится, потратит ваши кредиты.
Как отключить. Удалите сервер в клиенте (`claude mcp remove shodan`) и при необходимости отзовите ключ API в аккаунте Shodan.
Частые вопросы
Как подключить mcp-shodan к Claude Code?
Выполните `claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan`. Для Codex есть `codex mcp add`, для Gemini CLI `gemini mcp add`.
Нужен ли платный ключ Shodan?
Нужен собственный ключ Shodan. Часть инструментов бесплатна, включая CVEDB, `ip_lookup` и подсчет, а `shodan_search` с фильтрами и `domain_info` тратят кредиты плана.
Сколько стоит поиск?
Поиск с фильтрами стоит один кредит запроса и по одному за каждую дополнительную страницу, `domain_info` один за вызов. Остаток покажет `api_info`.
Сканирует ли сервер сети?
Нет, инструменты только читают данные, уже собранные Shodan, и сами ничего не сканируют и не меняют.
Как запустить как общий сервис?
Переменными `MCP_TRANSPORT=httpStream`, `MCP_PORT=3000` и `SHODAN_API_KEY`, либо из образа Docker. Авторизации у HTTP-режима нет, поэтому порт держат на localhost или за проксированием.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который дает агенту разбор уязвимостей: данные NVD, EPSS, каталог CISA KEV, связки с MITRE ATT&CK и оценка риска CVE в одном запросе
Бесплатный MCP-сервер уязвимостей: CVE, GHSA, OSV, CISA KEV и EPSS в одной записи, плюс проверка файла зависимостей проекта.
cvENGINE находит внешние активы домена и уязвимости, которые уже эксплуатируют, а MCP-сервер ведет сканы из Claude Code
Сканер безопасности для MCP-серверов: ищет зашитые ключи, отравление инструментов и инъекции в коде репозитория.
Security Detections MCP — база правил детектирования
Security Detections MCP
MCP-сервер собирает правила Sigma, Splunk, Elastic и KQL в одну базу: агент ищет детекторы и пробелы в покрытии ATT&CK
Мост между MCP-клиентом и терминалом Kali Linux: агент запускает nmap, sqlmap, hydra и другие инструменты для авторизованного пентеста и CTF
Коротко о README
README перечисляет возможности (разведка по хосту, поиск устройств, сведения об уязвимостях, DNS), схему работы и быстрый старт для трех клиентов. Дальше идут таблица одиннадцати инструментов с ценой в кредитах, режим HTTP и раздел о безопасности.