Shodan MCP Server Inspector

🚀 Shodan MCP 服務器

Shodan MCP 服務器實現了 Model Context Protocol (MCP)，通過標準化接口為用戶提供對 Shodan 互聯網掃描功能的便捷訪問，幫助用戶高效查詢設備、服務和漏洞信息。

🚀 快速開始

Shodan MCP 服務器藉助 Model Context Protocol 公開了 Shodan 強大的互聯網掃描與偵察能力，用戶可通過一致的接口查詢 Shodan 數據庫。

✨ 主要特性

• 搜索功能：支持使用高級過濾器查詢 Shodan 數據庫。
• DNS 解析：能解析域名並獲取詳細的 DNS 信息。
• CVE 信息：可獲取特定的 CVE 詳細信息。
• 獲取漏洞：能夠獲取與 IP 地址相關的詳細漏洞信息。
• 標準化接口：使用 MCP 協議實現一致通信。
• 環境變量支持：可通過環境變量安全管理 API 密鑰。

📦 安裝指南

先決條件

• Node.js (v14 或更高版本)
• npm (v6 或更高版本)
• Shodan API 密鑰

安裝步驟

1. 克隆倉庫：

git clone https://github.com/X3r0K/Shodan-MCP-Server-Inspector.git
cd shodan-mcp-server-Inspector

2. 安裝依賴項：

npm install

3. 在根目錄下創建一個 .env.local 文件，並添加你的 Shodan API 密鑰：

SHODAN_API_KEY=your_api_key_here

💻 使用示例

啟動服務器

1. 構建服務器：

npm run build

2. 啟動服務器：

node build/index.js

可用工具

搜索工具

• 查詢：使用 Shodan 的搜索語法進行查詢。
• 示例：log4j country:US city:Atlanta
• 返回：匹配設備的列表及其詳細信息。

DNS 解析工具

• 查詢：待解析的域名。
• 示例：example.com
• 返回：DNS 記錄及相關信息。

CVE 信息工具

• 查詢：CVE 標識符。
• 示例：CVE-2021-44228
• 返回：詳細的漏洞信息。

示例查詢

// 搜索具有 Log4j 漏洞的系統，在美國
{
  "query": "log4j country:US"
}

// 解析域名
{
  "query": "example.com"
}

// 獲取 CVE 信息
{
  "query": "CVE-2021-44228"
}

使用 MCP 檢查工具

你可以使用 MCP 檢查工具直接與服務器交互：

1. 安裝 MCP 檢查工具：

npm install -g @modelcontextprotocol/inspector

2. 使用檢查工具連接到你的服務器：

npx @modelcontextprotocol/inspector build/index.js

檢查工具提供以下功能：

• 測試所有可用工具
• 查看工具文檔
• 調試服務器響應
• 監控運行狀態

⚠️ 重要提示

請確保 API 密鑰的安全性，避免洩露。在生產環境中使用前，請測試所有功能。如有任何問題，請參考官方文檔或聯繫支持團隊。