Mcp Shodan

io.github.daedalus由 GitHub 帳號 daedalus 發布v0.1.0更新於 Oct 27, 2026

MCP server exposing all Shodan API functionality

已驗證STDIO僅桌面網頁搜尋與抓取安全與監控

概覽

AI 產生的概覽

本機 MCP 伺服器，封裝 Shodan 網際網路裝置搜尋 API，讓助理查詢主機、執行搜尋、管理警示並發起掃描。

可以做什麼
  • 查詢主機與搜尋：取得 IP 的詳細資訊、搜尋 Shodan 資料庫、以游標逐筆取得結果、統計結果數量、查看查詢詞彙資訊
  • 管理警示：列出、建立與刪除 Shodan 警示
  • 執行掃描：掃描網段、依連接埠掃描網際網路、查詢掃描狀態
  • 瀏覽已儲存查詢：列出共享查詢、搜尋查詢、取得熱門標籤
  • 檢索漏洞利用資料庫並統計漏洞數量
  • 讀取 API 工具資訊：金鑰資訊、爬取的連接埠、支援的協定與服務
適用情境
適合資安研究、暴露面評估與偵察情境：需要助理查詢 IP、服務與漏洞利用相關的 Shodan 資料，或在對話中管理 Shodan 警示與掃描時使用。
執行需求
以本機程序方式執行，透過 pip 從 PyPI 安裝，需要 Python 環境。需要 Shodan API 金鑰，透過環境變數 SHODAN_API_KEY 提供，並需能連線至 Shodan API 的網路。僅支援桌面端。
安裝前請注意
API 金鑰以明文透過 SHODAN_API_KEY 傳入，可存取你的 Shodan 帳戶並受方案額度限制。工具可建立與刪除警示、發起網段或網際網路掃描，會改變帳戶狀態，並可能消耗付費查詢或掃描額度。查詢內容與目標位址會傳送至 Shodan 伺服器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Shodan，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

mcp-shodan

MCP server exposing Shodan API functionality via the Model Context Protocol.

[PyPI] [Python] [Coverage] [Ruff]

Install

bash
pip install mcp-shodan

Usage

bash
export SHODAN_API_KEY=your_api_keymcp-shodan

Or add to your MCP configuration:

json
{  "mcpServers": {    "shodan": {      "command": "mcp-shodan",      "env": {        "SHODAN_API_KEY": "your_api_key"      }    }  }}

Available Tools

Host Information

  • shodan_host - Get all available information on an IP address

Search

  • shodan_search - Search the Shodan database
  • shodan_search_cursor - Search and return an iterator
  • shodan_count - Get total number of search results
  • shodan_search_tokens - Get information about a search query

Alerts

  • shodan_alerts - List all active alerts
  • shodan_create_alert - Create a new alert
  • shodan_delete_alert - Delete an alert

Scanning

  • shodan_scan - Scan a network
  • shodan_scan_internet - Scan the internet on a port
  • shodan_scan_status - Get scan status

Saved Queries

  • shodan_queries - List shared search queries
  • shodan_queries_search - Search saved queries
  • shodan_queries_tags - Get popular query tags

Exploits

  • shodan_exploits_search - Search the Shodan Exploits archive
  • shodan_exploits_count - Get total exploit count

Utilities

  • shodan_info - Get API key information
  • shodan_ports - Get list of ports Shodan crawls
  • shodan_protocols - Get supported protocols
  • shodan_services - Get list of services

Example

python
# Get information about a hostshodan_host("1.1.1.1")
# Search for specific servicesshodan_search("apache", limit=10)
# Count results for a queryshodan_count("nginx")
# Check your API planshodan_info()

mcp-name: io.github.daedalus/mcp-shodan

來源：README.md，提交 f276d75

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分