shodan-mcp-server

これは、Shodan APIへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバーです。デバイスや脆弱性などの情報をプログラムでShodanに照会できます。

目次

• 導入

• インストール

• 構成

• Node.jsでの使用

• APIドキュメント

  • 取得IP情報

  • dns_lookup

  • get_vulnerabilities

  • cve_info

  • 検索

• プロジェクト構造

• 貢献

• ライセンス

Related MCP server: Shodan-MCP-Server

導入

shodan-mcp-serverモデルコンテキストプロトコル（MCP）を使用して、Shodan のインテリジェンスをアプリケーションに簡単に統合する方法を提供します。Shodan に対して様々な種類の情報をクエリできるツールがいくつか用意されています。

特徴

ホスト情報: IP アドレスに関する詳細情報を取得します。検索: Shodan のデータベースを検索構文を使用してクエリします。DNS ルックアップ: ドメイン名を解決します。CVE 情報: 特定の CVE 脆弱性に関する詳細を取得します。

インストール

1. リポジトリをクローンします。

   git clone https://github.com/X3r0K/Shodan-MCP-Server.git
   cd shodan-mcp-server

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ドキュメント

取得IP情報

特定の IP アドレスに関する情報を取得します。

入力：

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

出力：

IP アドレスに関する情報を含む JSON オブジェクト。

dns_lookup

指定されたドメインの DNS ルックアップを実行します。

入力：

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

出力：

解決された IP アドレスを含む JSON オブジェクト。

get_vulnerabilities

特定の 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

ライセンス

マサチューセッツ工科大学