w0h1v/mcp-shodan

Быстрый старт · Инструменты · HTTP · Безопасность · Устранение неполадок · Документы

mcp-shodan — это MCP-сервер, который предоставляет агентам ИИ доступ к API Shodan и Shodan CVEDB. Дайте агенту IP, имя хоста, поисковый запрос, продукт или CVE и получите то, что аналитик посмотрит: открытые порты и баннеры, сертификаты TLS, DNS и степень уязвимости с EPSS и статусом KEV.

[! ПРИМЕЧАНИЕ] Независимый проект, не связанный с Shodan. Вам нужен собственный ключ Shodan API.

Основные моменты

• Разведка хостов. Открытые порты, продукты и версии, известные CVE, данные сертификатов TLS (отпечаток пальца, JARM, JA3S), история облачного провайдера и баннеров для любого IPv4 или IPv6 адреса.
• Поиск по устройству. Синтаксис запросов Shodan с разбивкой страниц и фасетов (страна, организация, порт, уязвимость и др.), а также бесплатный режим только подсчёта для размера запроса.
• Интеллект уязвимостей. Детали CVE с CVSS v4/v3/v2, EPSS и KEV; CVE по продукту или CPE, сортируемые по EPSS. CVEDB бесплатен и не тратит кредиты запросов.
• DNS. Поддомены и DNS-записи для домена, а также перенаправленные и обратные поиски для множества имён или IP в одном вызове.
• **С кредитной историей.

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.

[!NOTE] 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.

How it works

flowchart LR
    A["AI agent(Claude, Codex, Gemini, VS Code)"] -->|"MCP over stdio or HTTP"| S["mcp-shodan"]
    S -->|"validate input,HTTPS + API key"| SH["Shodan REST API"]
    S -->|"HTTPS, no key"| C["Shodan CVEDB"]
    SH -->|"JSON"| S
    C -->|"JSON"| S
    S -->|"structured JSON text"| A

Quickstart