쇼단-mcp-서버

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

목차

• 소개

• 설치

• 구성

• Node.js와 함께 사용

• API 문서

  • get_ip_info

  • dns_lookup

  • 취약점 가져오기

  • cve_info

  • 찾다

• 프로젝트 구조

• 기여하다

• 특허

Related MCP server: Shodan-MCP-Server

소개

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": "string" // The IP address to query
}

산출:

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

dns_lookup

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

입력:

{
  "hostname": "string" // The hostname to resolve
}

산출:

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

취약점 가져오기

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

입력:

{
  "ip": "string" // The IP address to query for vulnerabilities
}

산출:

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

cve_info

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

입력:

{
  "cve": "string" // The CVE ID to query
}

산출:

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

찾다

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

입력:

{
  "query": "string" // The search query
}

산출:

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

프로젝트 구조

shodan-mcp-server/
├── .gitignore
├── package.json
├── README.md
├── tsconfig.json
└── src/
    ├── index.ts
    └── index.mts

특허

MIT