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 文件。

感謝您對該項目的支持！如果有任何問題，請隨時聯繫維護人員。