쇼단-mcp-서버

Shodan API에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 Shodan에 기기, 취약점 등에 대한 정보를 프로그래밍 방식으로 쿼리할 수 있습니다.

목차

• 소개

• 설치

• 구성

• Node.js와 함께 사용

• API 문서

  • get_ip_info

  • dns_lookup

  • 취약점 가져오기

  • cve_info

  • 찾다

• 프로젝트 구조

• 기여하다

• 특허

소개

shodan-mcp-server 모델 컨텍스트 프로토콜(MCP)을 사용하여 Shodan 인텔리전스를 애플리케이션에 간편하게 통합할 수 있는 방법을 제공합니다. Shodan에서 다양한 유형의 정보를 쿼리할 수 있는 여러 도구를 제공합니다.

특징

호스트 정보: IP 주소에 대한 자세한 정보를 얻으세요. 검색: Shodan의 검색 구문을 사용하여 데이터베이스를 쿼리하세요. DNS 조회: 도메인 이름을 확인하세요. CVE 정보: 특정 CVE 취약성에 대한 세부 정보를 얻으세요.

설치

1. 저장소를 복제합니다.

   지엑스피1

2. 종속성을 설치합니다.

   npm install

3. 프로젝트를 빌드하세요:

   npm run build

구성

1. Shodan 에서 Shodan API 키를 받으세요.

2. MCP 설정 파일(예: ~/.config/mcp/settings.json )에서 MCP 서버를 구성합니다.

   { "mcpServers": { "shodan": { "command": "node", "args": ["/path/to/shodan-mcp-server/build/index.js"], "env": { "SHODAN_API_KEY": "<your_shodan_api_key>" }, "disabled": false, "autoApprove": [] } } }

   <your_shodan_api_key> 실제 Shodan API 키로 바꾸고, /path/to/shodan-mcp-server shodan-mcp-server 디렉터리의 실제 경로로 바꾸세요.

Node.js와 함께 사용

@modelcontextprotocol/sdk 패키지를 사용하면 Node.js에서 MCP 서버를 사용할 수 있습니다.

1. MCP SDK를 설치하세요:

   npm install @modelcontextprotocol/sdk

2. use_mcp_tool 함수를 사용하여 도구를 호출합니다.

   import { use_mcp_tool } from '@modelcontextprotocol/sdk'; async function getIpInfo(ip) { const result = await use_mcp_tool('shodan', 'get_ip_info', { ip }); console.log(result); } getIpInfo('8.8.8.8');

API 문서

get_ip_info

특정 IP 주소에 대한 정보를 얻습니다.

입력:

산출:

IP 주소에 대한 정보를 담고 있는 JSON 객체입니다.

dns_lookup

주어진 도메인에 대한 DNS 조회를 수행합니다.

입력:

산출:

확인된 IP 주소를 포함하는 JSON 객체입니다.

취약점 가져오기

특정 IP 주소와 관련된 취약점을 추적합니다.

입력:

산출:

IP 주소와 관련된 취약점 목록을 담고 있는 JSON 객체입니다.

cve_info

특정 CVE ID에 대한 정보를 검색합니다.

입력:

산출:

CVE ID에 대한 정보가 포함된 JSON 객체입니다.

찾다

Shodan에서 쿼리와 일치하는 기기를 검색하세요.

입력:

산출:

쿼리와 일치하는 장치 목록을 포함하는 JSON 개체입니다.

프로젝트 구조

특허

MIT