w0h1v/mcp-shodan

어떤 프로젝트인가요?

핵심 기능

• 01IPv4 및 IPv6 주소에 대해 포트, 제품, CVE, TLS 세부 정보를 포함한 호스트 정찰을 수행합니다.
• 02Shodan 쿼리 문법을 사용해 기기를 검색하고 페이지네이션 및 facet별 결과를 확인합니다.
• 03크레딧을 사용하기 전에 검색 규모를 파악할 수 있는 무료 건수 조회를 제공합니다.
• 04CVEDB를 통해 CVSS, EPSS 및 KEV 데이터가 포함된 CVE와 CPE 정보를 조회합니다.
• 05일괄 정방향·역방향 DNS 조회와 서브도메인 열거를 지원합니다.
• 06Docker 이미지 지원과 함께 stdio 또는 HTTP 스트리밍 전송을 제공합니다.

활용 사례

• 보안 검토 중 AI 에이전트에게 특정 IP에서 어떤 서비스가 노출되어 있는지 물어봅니다.
• CVE가 KEV 카탈로그에 포함되어 있는지, EPSS 점수상 악용 가능성이 어느 정도인지 확인합니다.
• 유료 검색을 실행하기 전에 무료 건수 조회로 인터넷 전체 검색 규모를 파악합니다.
• 외부 공격 표면 인벤토리를 위해 서브도메인을 열거하고 DNS 레코드를 확인합니다.

빠른 시작

1. 1

   계정 페이지에서 Shodan API 키를 발급받으세요

2. 2

   Claude Code에 서버를 추가하세요

   claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan

사용 전 알아둘 점

• !본인 소유의 유료 또는 멤버십 Shodan API 키가 필요하며, 검색 필터를 사용하려면 멤버십 또는 유료 플랜이 필요합니다.
• !HTTP 전송에는 인증 기능이 없으므로 localhost에서만 실행하거나 인증 프록시 뒤에 두어야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

mcp-shodan은(는) 무엇인가요?

AI 에이전트가 인터넷 기기 검색, 호스트 정찰, DNS 및 CVE 인텔리전스를 위해 Shodan API와 CVEDB에 접근할 수 있게 하는 MCP 서버입니다. mcp-shodan은 Claude, Codex, Gemini CLI 등의 AI 에이전트를 Shodan API와 Shodan CVEDB에 연결하는 MCP 서버입니다. IP, 호스트 이름, 검색 쿼리, 제품 또는 CVE를 입력하면 에이전트가 열린 포트와 배너, TLS 인증서 세부 정보, DNS 레코드, EPSS 및 KEV 상태를 포함한 취약점 심각도 정보를 가져옵니다.

mcp-shodan은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mcp-shodan은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mcp-shodan은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mcp-shodan의 마지막 커밋은 2026년 11월 4일입니다.

mcp-shodan은(는) 어디에 사용할 수 있나요?

보안 검토 중 AI 에이전트에게 특정 IP에서 어떤 서비스가 노출되어 있는지 물어봅니다. CVE가 KEV 카탈로그에 포함되어 있는지, EPSS 점수상 악용 가능성이 어느 정도인지 확인합니다. 유료 검색을 실행하기 전에 무료 건수 조회로 인터넷 전체 검색 규모를 파악합니다. 외부 공격 표면 인벤토리를 위해 서브도메인을 열거하고 DNS 레코드를 확인합니다.

mcp-shodan는 어떻게 설치하나요?

계정 페이지에서 Shodan API 키를 발급받으세요 Claude Code에 서버를 추가하세요: claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan

mcp-shodan은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/w0h1v/mcp-shodan