w0h1v/mcp-shodan

クイックスタート · 道具・ HTTP · セキュリティ・ トラブルシューティング · ドキュメンタリー

mcp-shodanは、AIエージェントにShodan APIおよびShodan CVEDBへのアクセスを提供するMCPサーバーです。エージェントにIP、ホスト名、検索クエリ、製品、またはCVEを渡すと、アナリストが確認するようなもの、つまりオープンポートやバナー、TLS証明書、DNS、脆弱性の重大度(EPSSおよびKEVの状態)が返ってきます。

[!注] 独立プロジェクトで、Shodanとは関係ありません。独自のShodan APIキーが必要です。

ハイライト

• **ホスト偵察。※ オープンポート、製品およびバージョン、既知のCVE、TLS証明書の詳細(指紋認証、JARM、JA3S)、クラウドプロバイダーおよびIPv4またはIPv6アドレスのバナー履歴。
• デバイス検索。 ページングや面の内訳(国、組織、ポート、Vulnなど)を備えたShodanクエリ構文、さらにクエリのサイズ調整のための無料カウント専用モード。
• 脆弱性インテリジェンス。 CVSS v4/v3/v2、EPSS、KEVによるCVE詳細;製品別またはCPE別にCVEを表示し、EPSSでソート可能です。CVEDBは無料で、クエリクレジットを消費しません。
• DNS. ドメインのサブドメインとDNSレコード、そして1回の通話で多くの名前や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"]