mcp-shodan
mcp-shodan — MCP-сервер сообщества (автор — w0h1v). Shodan API: поиск устройств, разведка по IP и доменам, DNS и CVE. Ставится через Docker или через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- w0h1v
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- typescript
Уровень риска: medium
Только чтение данных Shodan; поиск с фильтрами тратит кредиты; HTTP-режим без аутентификации.
Настройка клиентов
{
"code": "codex mcp add shodan --env SHODAN_API_KEY=your-key -- npx -y @burtthecoder/mcp-shodan",
"lang": "sh",
"notes": "Нужен ключ API Shodan",
"verified": "docs"
}
Что умеет
mcp-shodan — MCP-сервер, который даёт ИИ-агентам доступ к API Shodan и базе уязвимостей Shodan CVEDB. Вы передаёте агенту IP-адрес, имя хоста, поисковый запрос, продукт или CVE и получаете то, на что посмотрел бы аналитик: открытые порты, версии ПО, известные уязвимости, сертификаты и DNS. Это независимый проект, не связанный с Shodan; нужен собственный ключ API Shodan.
Одиннадцать инструментов, все только на чтение:
ip_lookup— порты, продукты, CVE, TLS, местоположение и облачный провайдер для одного IP, по желанию с историей баннеров;shodan_search— поиск устройств на языке запросов Shodan с постраничной выдачей и разбивкой по стране, организации, порту и уязвимостям;shodan_count— только число совпадений и разбивка, без результатов (бесплатно);domain_info— поддомены и DNS-записи домена;dns_lookupиreverse_dns_lookup— прямое и обратное разрешение пачкой;cve_lookup— CVSS v4/v3/v2, EPSS, отметка KEV, ссылки и затронутые CPE для одной CVE;cpe_lookup— идентификаторы CPE 2.3 для названия продукта;cves_by_product— уязвимости продукта с фильтром по KEV и дате и сортировкой по EPSS;search_filtersиapi_info— допустимые фильтры и остаток кредитов вашего тарифа.
Платные запросы списывают кредиты Shodan: фильтрованный shodan_search стоит один кредит за запрос плюс по одному за каждую дополнительную страницу, domain_info — один кредит за вызов. Остальные инструменты, включая все запросы к CVEDB, бесплатны.
Кому подойдёт
- Специалистам по безопасности и пентестерам для разведки по открытым источникам.
- Аналитикам уязвимостей, которым нужны CVSS, EPSS и KEV по продукту или CVE.
- Администраторам, которые проверяют, что видно снаружи на их адресах.
Похожие серверы — в категории безопасность.
Установка
Нужны Node.js 20 или новее и ключ API Shodan в переменной SHODAN_API_KEY. Сервер запускается через npx -y @burtthecoder/mcp-shodan. По умолчанию он работает через stdio; с MCP_TRANSPORT=httpStream запускается отдельный HTTP-сервис (порт задаётся MCP_PORT, адрес — MCP_HOST, путь — MCP_ENDPOINT), есть и Docker-образ с проверкой состояния по адресу /health. Shodan пропускает примерно один запрос в секунду; фильтры поиска требуют платного тарифа или членства.
Подключение к клиентам
Команды приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodanНастройка для Claude Desktop, VS Code и запуска из исходников описана в отдельном руководстве в репозитории.
Проверка
Попросите агента вызвать api_info — он покажет ваш тариф и остаток кредитов. Затем спросите, что открыто на адресе 8.8.8.8 и входит ли CVE-2021-44228 в каталог KEV.
Примеры задач
Какие порты и версии ПО видны снаружи на нашем IP и есть ли у них известные уязвимости?Покажи уязвимости nginx из каталога KEV, отсортированные по EPSS.Риски
- Только чтение. Все инструменты читают данные; сервер ничего не сканирует сам и ничего не меняет.
- Расход кредитов. Поиск с фильтрами и
domain_infoтратят кредиты вашего тарифа Shodan. - HTTP без аутентификации. В режиме HTTP у сервера нет аутентификации: держите порт на localhost или за обратным прокси с проверкой доступа, иначе любой, кто до него доберётся, потратит ваши кредиты.
- Передача запросов. Всё, что вы ищете, отправляется в Shodan. Ключ API читается из окружения и уходит только на
api.shodan.io. - Законность. Используйте разведку только в отношении систем, которые вам разрешено исследовать.
Частые вопросы
Нужен ли платный тариф Shodan?
Для фильтров поиска — да; CVEDB, подсчёт совпадений, DNS и ip_lookup работают бесплатно.
Что делать при ошибке 401?
Проверьте, нет ли пробелов или кавычек вокруг ключа, и перезапустите клиент.
Можно ли запустить сервер для команды?
Да, в режиме HTTP или в Docker, но защитите порт — встроенной аутентификации нет.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
mcp
Поиск уязвимостей в коде с помощью Semgrep.
ida-pro-mcp
Плагин IDA Pro для анализа бинарников: декомпиляция, дизассемблирование и отчёты.
GhidraMCP
Реверс-инжиниринг в Ghidra: декомпиляция, переименование методов и списки классов и импортов.
jshookmcp
Реверс-инжиниринг JavaScript: более 700 инструментов.