Cyreslab AI Shodan MCP Server

🚀 Shodan MCP 服務器

Shodan MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供對 Shodan API 功能的訪問，允許 AI 助手查詢互聯網連接設備和服務的信息，為網絡信息查詢提供了便捷途徑。

✨ 主要特性

• 主機信息：可獲取特定 IP 地址的詳細信息。
• 搜索功能：支持在 Shodan 數據庫中搜索設備和服務。
• 網絡掃描：能掃描網絡範圍（CIDR 格式）以查找設備。
• SSL 證書信息：可獲取域 SSL 證書的詳細信息。
• IoT 設備搜索：能夠查找特定類型的 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 搜索查詢（例如：'apache country:US'）。
• page (可選)：結果的頁碼（默認值：1）。
• facets (可選)：要包含在搜索結果中的分面列表（例如：['country', 'org']）。
• max_items (可選)：數組中包含的最大項目數（默認值：5）。
• fields (可選)：結果中要包含的字段列表（例如：['ip_str', 'ports', 'location.country_name']）。
• summarize (可選)：是否返回結果摘要而不是完整數據（默認值：false）。

scan_network_range

掃描網絡範圍（CIDR 格式）以查找設備。 參數：

• cidr (必需)：網絡範圍的 CIDR 表示法。
• max_items (可選)：數組中包含的最大項目數（默認值：5）。
• fields (可選)：結果中要包含的字段列表。

get_ssl_certificate

獲取特定域 SSL 證書的信息。 參數：

• domain (必需)：要查詢的域。
• max_items (可選)：數組中包含的最大項目數（默認值：5）。
• fields (可選)：結果中要包含的字段列表。

search_iot_devices

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

• device_type (必需)：要搜索的設備類型。
• vendor (可選)：設備的供應商。
• model (可選)：設備的型號。

資源

可用資源

• /api/host/<ip>：獲取特定 IP 地址的主機信息。
• /api/search：執行 Shodan 搜索查詢。
• /api/certificate：獲取 SSL 證書信息。
• /api/iot：搜索 IoT 設備。

示例響應

查詢主機信息

{
    "ip": "192.168.1.1",
    "hostname": "router.home",
    "ports": [80, 443],
    "protocols": ["http", "https"]
}

搜索結果

[
    {
        "ip": "10.0.0.1",
        "device_type": "router",
        "vendor": "Cisco"
    },
    {
        "ip": "10.0.0.2",
        "device_type": "camera",
        "vendor": "Axis"
    }
]

API 限制

• 每次調用的最多返回項數為 5。
• 需要有效的 Shodan API 密鑰才能進行身份驗證。
• 搜索功能可能受到速率限制。

📄 許可證

本項目遵循 MIT 許可證。請參閱 LICENSE 文件以獲取詳細信息。

貢獻者

感謝所有貢獻者！請查看 CONTRIBUTORS.md 以瞭解完整列表。

聯繫方式

如果有任何問題或反饋，請聯繫 support@cyberlabs.com。