Nmapmcp

🚀 NmapMCP

NmapMCP 是一款強大的集成工具，它將網絡掃描利器 Nmap 與模型上下文協議（MCP）相結合。藉助該工具，用戶能在 MCP 兼容環境中無縫開展網絡掃描工作，可通過 MCP 接口直接執行熱門端口掃描、DNS 暴力破解等多種網絡掃描任務。

🚀 快速開始

NmapMCP 讓用戶可以輕鬆在 MCP 兼容環境下進行網絡掃描。你可以通過 Smithery 便捷安裝，也能手動完成安裝步驟。

✨ 主要特性

• 熱門端口掃描：能快速識別目標主機上常用端口，幫助評估潛在入侵點。
• DNS 暴力破解：可發現與目標域名關聯的子域，助力構建全面的域名映射。
• 列表掃描：獲取指定範圍內活躍主機清單，無需進行端口掃描，適用於網絡資產清查。
• 操作系統檢測：通過分析網絡響應確定目標主機的操作系統，輔助進行漏洞評估。
• 版本檢測：識別開放端口上運行的服務版本，便於發現過時或有漏洞的服務。
• FIN 掃描：發送 FIN 數據包進行隱蔽掃描，探測開放端口且不建立完整連接。
• 空閒掃描：利用空閒主機進行高度隱蔽的掃描，降低被檢測的風險。
• Ping 掃描：發送 ICMP 回聲請求檢測網絡中的活躍主機，適用於網絡測繪。
• SYN 掃描：執行半開 TCP 掃描，識別開放端口而不完成 TCP 握手，降低被發現的可能性。
• TCP 連接掃描：建立完整的 TCP 連接來探測開放端口，在 SYN 掃描不可行時尤為有用。
• UDP 掃描：識別目標主機上的開放 UDP 端口，檢測不使用 TCP 的服務。
• 僅端口掃描：專注於端口掃描，不進行額外的主機發現，優化掃描流程。
• 無端口掃描：在不探測服務的情況下執行主機發現，適合快速識別活躍主機。
• ARP 發現：通過 ARP 請求識別本地網絡段中的活動設備，適用於局域網環境。
• 禁用 DNS 解析：執行掃描時無需將 IP 地址解析為域名，降低依賴性。

📦 安裝指南

通過 Smithery 安裝

訪問 Smithery 即可獲得無縫安裝體驗。

手動安裝

1. 克隆倉庫：

git clone https://github.com/yourusername/nmapmcp.git
cd nmapmcp

2. 安裝依賴項： 安裝 uv 工具以運行項目：

npm install uv

3. 創建虛擬環境（可選）：

uv init
uv run

4. 安裝依賴項：

npm install

📚 詳細文檔

配置

編輯 claude_desktop_config.json 文件來自定義設置：

{
  "configuration": {
    "nmap_path": "/path/to/nmap",
    "mcp_endpoint": "http://localhost:8080"
  }
}

貢獻指南

1. 克隆倉庫：

git clone https://github.com/yourusername/nmapmcp.git
cd nmapmcp

2. 創建分支：

git checkout -b feature/new-feature

3. 提交更改：

git add .
git commit -m "添加新功能"
git push origin feature/new-feature

4. 提出拉取請求：訪問原始倉庫 NmapMCP，點擊“New Pull Request”以提交更改。

📄 許可證

該項目採用 MIT 許可證。

👏 致謝

特別感謝 Nmap 和 MCP 社區提供的寶貴工具和技術支持。