Shodan MCP Server

🚀 Shodan MCP 服務器

Shodan MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供了對 Shodan API 功能的訪問。藉助該服務器，AI 助手能夠輕鬆查詢互聯網連接設備和服務的相關信息，為信息獲取提供了極大的便利。

🚀 快速開始

此服務器能讓 AI 助手查詢互聯網連接設備和服務的信息。按以下步驟操作，即可輕鬆開啟使用之旅。

✨ 主要特性

• 主機信息：可獲取特定 IP 地址的詳細信息。
• 搜索功能：支持在 Shodan 數據庫中搜索設備和服務。
• 網絡掃描：能掃描網絡範圍（CIDR 格式）以查找設備。
• SSL 證書信息：可獲取域 SSL 證書的詳細信息。
• 物聯網設備搜索：能夠查找特定類型的 IoT 設備。

📦 安裝指南

按照以下步驟完成服務器的安裝：

1. 克隆倉庫：

   git clone https://github.com/Cyreslab-AI/shodan-mcp-server.git
   cd shodan-mcp-server
   

2. 安裝依賴項：

   npm install
   

3. 構建服務器：

   npm run build
   

4. 設置你的 Shodan API 密鑰：

   export SHODAN_API_KEY="your-api-key-here"
   

5. 啟動服務器：

   npm start
   

📚 詳細文檔

MCP 集成

此服務器可與 Claude 或其他兼容 MCP 的 AI 助手集成。要將其添加到 Claude Desktop 或 Claude.app 中，可按以下步驟操作：

1. 將服務器添加到你的 MCP 設置中：

   {
     "mcpServers": {
       "shodan": {
         "command": "node",
         "args": ["/path/to/shodan-mcp-server/build/index.js"],
         "env": {
           "SHODAN_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

2. 重啟 Claude 以加載新的 MCP 服務器。

可用工具

get_host_info

獲取特定 IP 地址的詳細信息。 參數：

• ip（必需）：要查找的 IP 地址
• max_items（可選）：數組中包含的最大項目數（默認值：5）
• fields（可選）：結果中要包含的字段列表（例如，['ip_str', 'ports', 'location.country_name']）

search_shodan

在 Shodan 數據庫中搜索設備和服務。 參數：

• query（必需）：Shodan 搜索查詢（例如，"web server"）
• page（可選）：結果頁碼
• limit（可選）：每頁的結果數量

scan_network

掃描網絡範圍以查找設備。 參數：

• cidr（必需）：要掃描的 CIDR 範圍（例如，"192.168.1.0/24"）

get_ssl_certificate

獲取域 SSL 證書的詳細信息。 參數：

• domain（必需）：要查找的域名

search_iot_devices

查找特定類型的 IoT 設備。 參數：

• device_type（可選）：設備類型過濾器
• vendor（可選）：設備供應商過濾器

資源

特定資源可以通過以下 URL 訪問：

https://api.shodan.io/labs/[resource]

API 限制

• 免費 API：提供基本功能，有速率限制。
• 付費 API：提供更多高級功能和更高的請求限制。

📄 許可證

項目使用 MIT 許可證。

開發者信息

由 [Your Name] 開發。