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 オブジェクト。

プロジェクト構造

ライセンス

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