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 레코드, 그리고 한 통화에서 여러 이름이나 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"]