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-режим без аутентификации.

Настройка клиентов

codex
{
    "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.

Риск: medium Лицензия: LGPL-2.1 ★ 17 617

ida-pro-mcp

Плагин IDA Pro для анализа бинарников: декомпиляция, дизассемблирование и отчёты.

Риск: medium Лицензия: MIT ★ 13 382

GhidraMCP

Реверс-инжиниринг в Ghidra: декомпиляция, переименование методов и списки классов и импортов.

Риск: high Лицензия: Apache-2.0 ★ 11 898

jshookmcp

Реверс-инжиниринг JavaScript: более 700 инструментов.

Риск: medium Лицензия: AGPL-3.0 ★ 2 105

Источники