쇼단 MCP 서버

Shodan API 기능에 대한 액세스를 제공하는 MCP(Model Context Protocol) 서버로, AI 도우미가 인터넷에 연결된 장치와 서비스에 대한 정보를 쿼리할 수 있도록 합니다.

특징

• 호스트 정보 : 특정 IP 주소에 대한 자세한 정보를 얻으세요
• 검색 기능 : Shodan 데이터베이스에서 장치 및 서비스 검색
• 네트워크 스캐닝 : 장치의 네트워크 범위(CIDR 표기법)를 스캔합니다.
• SSL 인증서 정보 : 도메인에 대한 SSL 인증서 세부 정보 가져오기
• IoT 기기 검색 : 특정 유형의 IoT 기기 찾기

설치

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install
3. 서버를 빌드하세요:
   npm run build
4. Shodan API 키를 설정하세요:
   export SHODAN_API_KEY="your-api-key-here"
5. 서버를 시작합니다:
   npm start

MCP 통합

이 서버는 Claude 또는 다른 MCP 호환 AI 어시스턴트와 통합될 수 있습니다. Claude Desktop 또는 Claude.app에 추가하려면 다음 단계를 따르세요.

1. MCP 설정에 서버를 추가합니다.
   { "mcpServers": { "shodan": { "command": "node", "args": ["/path/to/shodan-mcp-server/build/index.js"], "env": { "SHODAN_API_KEY": "your-api-key-here" } } } }
2. 새로운 MCP 서버를 로드하려면 Claude를 다시 시작하세요.

사용 가능한 도구

get_host_info

특정 IP 주소에 대한 자세한 정보를 얻으세요.

매개변수:

• ip (필수): 조회할 IP 주소
• max_items (선택 사항): 배열에 포함할 최대 항목 수(기본값: 5)
• fields (선택 사항): 결과에 포함할 필드 목록(예: ['ip_str', 'ports', 'location.country_name'])

검색_쇼단

Shodan의 데이터베이스에서 장치와 서비스를 검색합니다.

매개변수:

• query (필수): Shodan 검색 쿼리(예: 'apache country:US')
• page (선택 사항): 결과 페이지 번호(기본값: 1)
• facets (선택 사항): 검색 결과에 포함할 facet 목록(예: ['country', 'org'])
• max_items (선택 사항): 배열에 포함할 최대 항목 수(기본값: 5)
• fields (선택 사항): 결과에 포함할 필드 목록(예: ['ip_str', 'ports', 'location.country_name'])
• summarize (선택 사항): 전체 데이터 대신 결과 요약을 반환할지 여부(기본값: false)

스캔 네트워크 범위

장치의 네트워크 범위(CIDR 표기법)를 스캔합니다.

매개변수:

• cidr (필수): CIDR 표기법으로 나타낸 네트워크 범위(예: 192.168.1.0/24)
• max_items (선택 사항): 결과에 포함할 최대 항목 수(기본값: 5)
• fields (선택 사항): 결과에 포함할 필드 목록(예: ['ip_str', 'ports', 'location.country_name'])

get_ssl_info

도메인에 대한 SSL 인증서 정보를 가져옵니다.

매개변수:

• domain (필수): SSL 인증서를 조회할 도메인 이름(예: example.com)

IoT 기기 검색

특정 유형의 IoT 기기를 검색하세요.

매개변수:

• device_type (필수): 검색할 IoT 기기의 유형(예: '웹캠', '라우터', '스마트 TV')
• country (선택 사항): 검색을 제한하기 위한 선택 국가 코드(예: 'US', 'DE')
• max_items (선택 사항): 결과에 포함할 최대 항목 수(기본값: 5)

사용 가능한 리소스

• shodan://host/{ip} : 특정 IP 주소에 대한 정보

API 제한 사항

일부 Shodan API 엔드포인트는 유료 멤버십이 필요합니다. 다음 기능은 유료 Shodan API 키를 통해서만 사용할 수 있습니다.

• 검색 기능
• 네트워크 스캐닝
• SSL 인증서 조회
• IoT 기기 검색

특허

MIT

개발자

사이레스랩.ai