MCP Shodan

🚀 MCP（マルウェア対策）サーバーモジュール

このプロジェクトは、Shodan APIを使用して構築されたMCP（マルウェア対策）サーバーモジュールです。DNS解析、逆DNS検索、IPv4の地理的位置特定、CVEやCPEの脆弱性情報の検索など、様々な機能をサポートしています。

🚀 クイックスタート

📦 インストール

1. グローバルインストール：

   npm install mcp-shodan@latest -g
   

2. 設定ファイルの作成：

   # デフォルトの場所にconfig.jsonを作成
   mcp-shodan init-config
   # カスタムパスに設定ファイルを作成
   mcp-shodan init-config --path /custom/path/config.json
   

設定

以下の内容をClaude Desktopの設定ファイルに追加してください：

{
  "mcpServers": {
    "shodan": {
      "command": "mcp-shodan",
      "env": {
        "SHODAN_API_KEY": "your-actual-api-key-here"
      }
    }
  }
}

起動

1. グローバルインストールの設定で起動：

   mcp-shodan start
   

2. カスタムパスの設定で起動：

   mcp-shodan start --path /custom/path/config.json
   

✨ 主な機能

💻 使用例

基本的な使用法

DNS解析

{
  "dns_lookup": {
    "hostnames": ["google.com", "example.com"]
  }
}

戻り値の形式は次の通りです：

{
  "resolve": {
    "google.com": "172.217.14.206",
    "example.com": "93.184.216.3"
  }
}

反向DNS查询

{
  "reverse_dns": {
    "ips": ["172.217.14.206", "93.184.216.3"]
  }
}

戻り値の形式は次の通りです：

{
  "reverse": {
    "172.217.14.206": "google.com",
    "93.184.216.3": "example.com"
  }
}

IPv4地理位置定位

{
  "ip_geo": {
    "ips": ["172.217.14.206", "93.184.216.3"]
  }
}

戻り値の形式は次の通りです：

[
  {
    "ip": "172.217.14.206",
    "city": "Mountain View",
    "region": "California",
    "country_name": "アメリカ合衆国",
    "latitude": 37.3568,
    "longitude": -122.090
  },
  {
    "ip": "93.184.216.3",
    "city": "Ermont",
    "region": "Île-de-France",
    "country_name": "フランス",
    "latitude": 48.95,
    "longitude": 2.07
  }
]

CVE查询

{
  "cve_search": {
    "cves": ["CVE-2013-0809", "CVE-2015-5606"]
  }
}

戻り値の形式は次の通りです：

[
  {
    "cve_id": "CVE-2013-0809",
    "summary": "Javaの逆シリアル化脆弱性で、複数のバージョンのOracle Java SEに影響を与えます。",
    "severity": "高リスク"
  },
  {
    "cve_id": "CVE-2015-5606",
    "summary": "Adobe Flash Playerのリモートコード実行脆弱性。",
    "severity": "重大"
  }
]

CPE匹配

{
  "cpe_match": {
    "cpes": ["cpe:/a:apple:safari", "cpe:/o:microsoft:windows"]
  }
}

戻り値の形式は次の通りです：

[
  {
    "cpe": "cpe:/a:apple:safari",
    "vendors": ["Apple"],
    "products": ["Safari"]
  },
  {
    "cpe": "cpe:/o:microsoft:windows",
    "vendors": ["Microsoft"],
    "products": ["Windows"]
  }
]

🔧 エラーハンドリング

パラメータエラー

{
  "error": {
    "code": 400,
    "message": "パラメータの形式が無効です。"
  }
}

API呼び出しエラー

{
  "error": {
    "code": 503,
    "message": "Shodanサービスに接続できません。"
  }
}

📚 ドキュメント

プロジェクト構造

mcp-shodan/
├── src/                 # ソースコードディレクトリ
│   ├── main.js          # メインプログラムのエントリーポイント
│   └── modules/         # 機能モジュール
│       ├── dns_lookup.js    # DNS解析機能
│       └── reverse_dns.js  # 逆DNS検索機能
├── config/              # 設定ファイルディレクトリ
│   └── config.json      # デフォルトの設定ファイル
└── package.json        # プロジェクトの依存関係管理

使用方法

設定ファイルの初期化

mcp-shodan init-config [--path <パス>]
# 例：
$ mcp-shodan init-config --path /custom/path

サービスの起動

mcp-shodan start [--path <パス>]
# 例：
$ mcp-shodan start

バージョン履歴

コントリビューションガイド

コードの提出

git clone https://github.com/yourusername/mcp-shodan.git
cd mcp-shodan
npm run dev

問題の作成

GitHubで新しい問題を作成してください：https://github.com/yourusername/mcp-shodan/issues

📄 ライセンス

このプロジェクトはMITライセンスを使用しています。詳細については、LICENSEファイルを参照してください。

このプロジェクトへのご支援に感謝いたします！何か問題があれば、いつでもメンテナにご連絡ください。