shodan-mcp-server

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

目次

• 導入

• インストール

• 構成

• Node.jsでの使用

• APIドキュメント

  • 取得IP情報

  • dns_lookup

  • get_vulnerabilities

  • cve_info

  • 検索

• プロジェクト構造

• 貢献

• ライセンス

導入

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 アドレスに関する情報を含む JSON オブジェクト。

dns_lookup

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

入力：

出力：

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

get_vulnerabilities

特定の IP アドレスに関連付けられた脆弱性を追跡します。

入力：

出力：

IP アドレスに関連付けられた脆弱性のリストを含む JSON オブジェクト。

cve_info

特定の CVE ID に関する情報を取得します。

入力：

出力：

CVE ID に関する情報を含む JSON オブジェクト。

検索

クエリに一致するデバイスを Shodan で検索します。

入力：

出力：

クエリに一致するデバイスのリストを含む JSON オブジェクト。

プロジェクト構造

ライセンス

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