Добавить сервер
BurtTheCoder/mcp-shodan
  1. Каталог MCP
  2. BurtTheCoder/mcp-shodan

BurtTheCoder/mcp-shodan

от burtthecoder
MCP-сервер для работы с Shodan API и CVEDB: IP-разведка, DNS-запросы, поиск устройств и уязвимостей. Помогает анализировать сетевую инфраструктуру и отслеживать угрозы. Для специалистов по безопасн...
GithubNPMСайт сервера

MCP Shodan: network intelligence for AI agents. Internet reconnaissance, DNS intelligence and CVE analysis over the Model Context Protocol.

npm version CI License: MIT Node 20 or newer MCP Registry Smithery

Quickstart · Tools · HTTP · Security · Troubleshooting · Docs

mcp-shodan is an MCP server that gives AI agents access to the Shodan API and Shodan CVEDB. Hand your agent an IP, hostname, search query, product or CVE and get back what an analyst would look at: open ports and banners, TLS certificates, DNS, and vulnerability severity with EPSS and KEV status.

Заметка

Independent project, not affiliated with Shodan. You need your own Shodan API key.

Highlights

  • Host reconnaissance. Open ports, products and versions, known CVEs, TLS certificate details (fingerprint, JARM, JA3S), cloud provider and banner history for any IPv4 or IPv6 address.
  • Device search. Shodan query syntax with paging and facet breakdowns (country, org, port, vuln and more), plus a free count-only mode for sizing a query.
  • Vulnerability intelligence. CVE details with CVSS v4/v3/v2, EPSS and KEV; CVEs by product or CPE, sortable by EPSS. CVEDB is free and doesn't spend query credits.
  • DNS. Subdomains and DNS records for a domain, and forward and reverse lookups for many names or IPs in one call.
  • Credit-aware. Free tools are marked as free, and api_info shows the credits left on your plan.
  • Two transports. stdio for desktop clients, HTTP streaming for a shared service.
  • Tested. Unit tests with a mocked Shodan API run in CI on Node 20, 22 and 24.

Часто задаваемые вопросы

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

Показывает тарифный план Shodan API, оставшиеся кредиты на запросы и сканирование, отслеживаемые IP-адреса и лимиты использования для настроенного ключа API. Бесплатно: кредиты не расходуются.

Параметры

Без параметров.

cpe_lookupтолько чтениевнешний мир

Ищет записи Common Platform Enumeration (CPE) по названию продукта в CVEDB Shodan. Поддерживает пагинацию и может вернуть либо полные сведения о CPE, либо только общее количество. Помогает определить конкретные версии и конфигурации программного и аппаратного обеспечения.

Параметры
  • countboolean

    Если true, возвращает только количество совпавших CPE.

  • limitinteger

    Максимальное количество CPE для возврата (не более 1000).

  • productstringобязательный

    Название продукта для поиска CPE.

  • skipinteger

    Количество CPE, которые нужно пропустить (для пагинации).

cve_lookupтолько чтениевнешний мир

Запрашивает подробную информацию об уязвимостях из CVEDB Shodan. Возвращает исчерпывающие сведения о CVE, включая оценки CVSS (v4/v3/v2), вероятность и рейтинг EPSS, статус KEV, предлагаемые меры по устранению, связи с программами-вымогателями и затронутые продукты (CPEs).

Параметры
  • cvestringобязательный

    Идентификатор CVE для запроса (формат: CVE-YYYY-NNNNN).

cves_by_productтолько чтениевнешний мир

Ищет уязвимости, затрагивающие конкретные продукты или CPE. Поддерживает фильтрацию по статусу KEV, сортировку по оценке EPSS, диапазонам дат и пагинацию. Может искать по имени продукта или идентификатору CPE 2.3. Возвращает подробную информацию об уязвимостях, включая оценки серьезности и анализ воздействия.

Параметры
  • countboolean

    Если true, возвращает только количество совпадающих CVE.

  • cpe23string

    Идентификатор CPE версии 2.3 (формат: cpe:2.3:часть:производитель:продукт:версия).

  • end_datestring

    Конечная дата для фильтрации CVE (формат: ГГГГ-ММ-ДДTЧЧ:ММ:СС).

  • is_kevboolean

    Если значение true, возвращает только CVE с установленным флагом KEV.

  • limitinteger

    Максимальное количество CVE для возврата (макс. 1000).

  • productstring

    Название продукта для поиска CVE.

  • skipinteger

    Количество CVE для пропуска (для пагинации).

  • sort_by_epssboolean

    Если true, сортирует CVE по убыванию оценки EPSS.

  • start_datestring

    Дата начала для фильтрации CVE (формат: ГГГГ-ММ-ДДTЧЧ:ММ:СС).

dns_lookupтолько чтениевнешний мир

Разрешает доменные имена в IP-адреса с помощью DNS-сервиса Shodan. Поддерживает пакетное разрешение нескольких hostname в одном запросе. Возвращает IP-адреса, сопоставленные с соответствующими им hostname.

Параметры
  • hostnamesstring[]обязательный

    Список имен хостов для разрешения.

domain_infoтолько чтениевнешний мир

Получает субдомены и DNS-записи для домена из Shodan. Стоит 1 кредит запроса за один поиск.

Параметры
  • domainstringобязательный

    Домен для поиска, например example.com.

  • historyboolean

    Включает исторические данные DNS.

  • pageinteger

    Номер страницы результата.

  • typeenum

    Возвращает только DNS-записи этого типа.

ip_lookupтолько чтениевнешний мир

Получает исчерпывающую информацию об IP-адресе, включая геолокацию, операционную систему, открытые порты, запущенные сервисы (продукт, версия, CPE), известные уязвимости (CVE), SSL-сертификаты, имена хостов и сведения о облачном провайдере, если они доступны. Возвращает баннеры сервисов и информацию об HTTP-сервере, когда они есть. Необязательный history возвращает исторические баннеры; minify пропускает баннеры.

Параметры
  • historyboolean

    Включает исторические баннеры. Добавляет раздел 'Banner History' со строкой на каждый порт, продукт и версию, где видно, когда баннер впервые и в последний раз заметили и сколько раз он попадался; Services по-прежнему показывает последний баннер по каждому порту.

  • ipanyобязательный

    IP-адрес (IPv4 или IPv6) для запроса.

  • minifyboolean

    Возвращает только базовую информацию о хосте и список портов, без баннеров.

reverse_dns_lookupтолько чтениевнешний мир

Выполняет обратные DNS-запросы для поиска имен хостов, связанных с IP-адресами. Поддерживает пакетные запросы нескольких IP-адресов в одном запросе. Возвращает все известные имена хостов для каждого IP-адреса с четким указанием, когда имена хостов не найдены.

Параметры
  • ipsstring[]обязательный

    Выполняет обратный DNS-запрос для списка IP-адресов.

search_filtersтолько чтениевнешний мир

Перечисляет поисковые фильтры и фасеты, которые поддерживает Shodan. Используйте это, чтобы строить корректные запросы и фасеты для shodan_search и shodan_count. Бесплатно: не расходует кредиты.

Параметры

Без параметров.

shodan_countтолько чтениевнешний мир

Возвращает общее количество результатов Shodan по запросу, с необязательной разбивкой по фасетам (например, country, org, port). Бесплатно: не расходует кредиты на запросы. Используйте search_filters, чтобы вывести список допустимых фильтров и фасетов.

Параметры
  • facetsstring

    Фасеты через запятую, при необходимости с количеством, например 'country:10,org,port'.

  • querystringобязательный

    Поисковый запрос для Shodan.

shodan_searchтолько чтениевнешний мир

Ищет в базе данных Shodan устройства, подключённые к интернету. Возвращает подробную информацию о подходящих устройствах, включая сервисы, уязвимости и географическое распределение. Поддерживает расширенные фильтры поиска и возвращает статистику по фасетам (по умолчанию: по стране). Списывает 1 кредит запроса, когда запрос использует фильтры, плюс 1 за каждую страницу после первой. Используйте shodan_count (бесплатно), чтобы получить общее количество и фасеты без результатов.

Параметры
  • facetsstring

    Фасеты, разделённые запятыми, для сводной статистики, при необходимости с количеством, например 'country:10,org,port'. Используйте search_filters, чтобы вывести список допустимых фасетов.

  • max_resultsinteger

    Максимальное количество результатов для возврата (1-100; одна страница Shodan).

  • pageinteger

    Номер страницы результатов (100 результатов на странице). Каждая страница после первой стоит 1 кредит запроса.

  • querystringобязательный

    Поисковый запрос для Shodan.

1.0.34основная
1.0.33
1.0.32
1.0.31
1.0.30
1.0.22
1.0.21
1.0.20
1.0.16
1.0.15
1.0.14
1.0.13
1.0.12
1.0.11
1.0.10
1.0.9
1.0.8
1.0.7
1.0.6
1.0.5
1.0.4

Выберите клиент, чтобы установить BurtTheCoder/mcp-shodan:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "burtthecoder-mcp-shodan-2g3t5z715s": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "burtthecoder-mcp-shodan-2g3t5z715s": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "burtthecoder-mcp-shodan-2g3t5z715s": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"burtthecoder-mcp-shodan-2g3t5z715s\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@burtthecoder/mcp-shodan\"],\"env\":{\"SHODAN_API_KEY\":\"your-shodan-api-key\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "burtthecoder-mcp-shodan-2g3t5z715s": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add burtthecoder-mcp-shodan-2g3t5z715s --env SHODAN_API_KEY=your-shodan-api-key -- npx -y @burtthecoder/mcp-shodan

Либо через JSON-конфиг:

claude mcp add-json burtthecoder-mcp-shodan-2g3t5z715s "{\"command\":\"npx\",\"args\":[\"-y\",\"@burtthecoder/mcp-shodan\"],\"env\":{\"SHODAN_API_KEY\":\"your-shodan-api-key\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add burtthecoder-mcp-shodan-2g3t5z715s --env SHODAN_API_KEY=your-shodan-api-key -- npx -y @burtthecoder/mcp-shodan

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.burtthecoder-mcp-shodan-2g3t5z715s]
command = "npx"
args = ["-y", "@burtthecoder/mcp-shodan"]

[mcp_servers.burtthecoder-mcp-shodan-2g3t5z715s.env]
SHODAN_API_KEY = "your-shodan-api-key"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите BurtTheCoder/mcp-shodan, а в поле команды запуска — строку ниже:
npx -y @burtthecoder/mcp-shodan

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "burtthecoder-mcp-shodan-2g3t5z715s": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "burtthecoder-mcp-shodan-2g3t5z715s": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например burtthecoder-mcp-shodan-2g3t5z715s.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: burtthecoder-mcp-shodan-2g3t5z715s
    command: npx
    args:
      - "-y"
      - "@burtthecoder/mcp-shodan"
    env:
      SHODAN_API_KEY: your-shodan-api-key
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "burtthecoder-mcp-shodan-2g3t5z715s": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-shodan"
      ],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}

Похожие MCP-сервера

operantlabs/operant-mcp

operantlabs/operant-mcp

от operantlabs

MCP-сервер с 51 инструментом для пентеста и анализа безопасности: SQL-инъекции, XSS, сетевая криминалистика (PCAP), анализ памяти, рекон. Полезен специалистам по ИБ для автоматизации тестирования у...

TypeScript⭐ 25
ofershap/mcp-server-dns

ofershap/mcp-server-dns

от ofershap

MCP-сервер для DNS-запросов, reverse DNS и WHOIS без API-ключей. Полезен разработчикам при отладке почты, настройке доменов или проверке владельца сайта. Работает «из коробки» с любым MCP-клиентом.

TypeScript⭐ 3
fr0gger/MCP_Security

fr0gger/MCP_Security

от fr0gger

MCP сервер для поиска и анализа угроз через API ORKL. Предоставляет инструменты для детального просмотра отчётов, threat actors и источников. Полезен специалистам по кибербезопасности для быстрого доступа к данным разведки угроз.

Python⭐ 52
BurtTheCoder/mcp-virustotal

BurtTheCoder/mcp-virustotal

от burtthecoder

MCP сервер для VirusTotal: проверяет безопасность URL, файлов и IP-адресов (включая домены), автоматически собирая связанные данные. Включает поиск по корпусу, сводки поведения и коллекции угроз. Помогает аналитикам ИБ быстро исследовать угрозы через Claude Desktop.

TypeScript⭐ 151
antonio-mello-ai/mcp-pfsense

antonio-mello-ai/mcp-pfsense

от antonio-mello-ai

MCP сервер для управления брандмауэрами pfSense через AI-ассистентов. 17 инструментов по шести категориям: система, правила, DHCP, DNS, мониторинг и сервисы. Безопасность с двухшаговым подтверждени...

Python⭐ 6
davidlin2k/pox-mcp-server

davidlin2k/pox-mcp-server

от davidlin2k

MCP-сервер для управления SDN-сетями через контроллер POX. Позволяет управлять OpenFlow-коммутаторами, настраивать потоки и анализировать топологию. Полезен для сетевых инженеров и исследователей, ...

Python⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин