shodan — MCP-сервер для Claude Code: разведка по IP и CVE
Подключает Shodan к агенту: открытые порты и баннеры, TLS-сертификаты, DNS и уязвимости с EPSS и KEV по одному запросу.
claude mcp add shodan -e SHODAN_API_KEY=<SHODAN_API_KEY> -- npx -y @burtthecoder/mcp-shodanЧто делает shodan
Сервер-обёртка над Shodan API и Shodan CVEDB отдаёт агенту одиннадцать инструментов только для чтения. ip_lookup собирает по адресу IPv4 или IPv6 порты, продукты с версиями, TLS-отпечатки вроде JARM и JA3S и облако, где живёт хост. shodan_search ищет устройства синтаксисом Shodan с постраничной выдачей и разбивкой по странам, организациям и портам, а shodan_count показывает одно число совпадений и ничего не стоит.
По уязвимостям работают cve_lookup, cpe_lookup и cves_by_product: CVSS, EPSS, статус в KEV, затронутые CPE. CVEDB бесплатен, квоту запросов он не тратит и ключ ему не нужен. DNS закрывают domain_info с поддоменами и записями, плюс пакетные dns_lookup и reverse_dns_lookup.
Нужны Node.js 20 или новее и собственный ключ Shodan, проект с самим Shodan не связан. Аргументы проверяются схемами zod до отправки запроса, поэтому кривой IP или номер CVE неверного формата до API не дойдёт. Транспорт по умолчанию stdio; в режиме httpStream у сервиса нет аутентификации, так что порт держите на localhost или за прокси. Всё, что вы запрашиваете, уходит на серверы Shodan. Поиск с фильтрами требует платного или членского плана, а лимит обращений близок к одному в секунду — на этом частый перебор и упирается.
Какие задачи решает
- узнать, какие порты и сервисы открыты у конкретного IP
- оценить по EPSS и KEV, насколько опасна найденная CVE
- найти поддомены и DNS-записи домена перед проверкой периметра
- перечислить уязвимости продукта по имени или CPE
- посчитать размер выдачи по поисковому запросу, не тратя квоту
Примеры запросов агенту
- Что открыто на 8.8.8.8 и есть ли CVE-2021-44228 в каталоге KEV?
- Посчитай через
shodan_count, сколько устройств с Apache в Германии, и разбей по портам - Найди поддомены example.com и резолвни их в IP
Как установить shodan
Командой платформы
claude mcp add shodan -e SHODAN_API_KEY=<SHODAN_API_KEY> -- npx -y @burtthecoder/mcp-shodanВместо <…> подставьте свои значения
Командой платформы
codex mcp add w0h1v-shodan --env SHODAN_API_KEY=<SHODAN_API_KEY> -- npx -y @burtthecoder/mcp-shodanВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"w0h1v-shodan": {
"command": "npx",
"args": [
"-y",
"@burtthecoder/mcp-shodan"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"w0h1v-shodan": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@burtthecoder/mcp-shodan"
],
"env": {
"SHODAN_API_KEY": "<SHODAN_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SHODAN_API_KEY=<SHODAN_API_KEY> w0h1v-shodan npx -y @burtthecoder/mcp-shodanВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о shodan
Как установить shodan в Claude Code?
Добавьте сервер командой claude mcp add shodan -e SHODAN_API_KEY=<SHODAN_API_KEY> -- npx -y @burtthecoder/mcp-shodan. Второй способ — с явным транспортом: claude mcp add --env SHODAN_API_KEY=<SHODAN_API_KEY> --transport stdio w0h1v-shodan -- npx -y @burtthecoder/mcp-shodan.
Что делает shodan?
Даёт агенту доступ к Shodan API и CVEDB: разведка хоста, поиск устройств, DNS и информация об уязвимостях. Инструменты только читают данные.
Почему shodan_search отвечает 403?
Фильтры поиска доступны на членском или платном плане. Проверьте тариф через api_info.
