Nmap Mcpserver

🚀 Nmap MCP 服務器

Nmap MCP 服務器基於模型控制協議（MCP）構建，為用戶提供便捷訪問 nmap 網絡掃描功能的途徑，可實現掃描操作、結果存儲與分析等功能。

🚀 快速開始

Nmap MCP 服務器能讓你輕鬆使用 nmap 進行網絡掃描。你可以按照以下步驟快速開啟使用：

1. 完成安裝步驟，確保系統滿足運行要求。
2. 按照使用方法啟動服務器，並調用相應工具開展掃描工作。

✨ 主要特性

• 可定製掃描：能在指定目標上運行 nmap 掃描，且掃描選項可自定義。
• 結果管理：支持存儲和檢索掃描結果，方便後續查看與分析。
• AI 分析：藉助 AI 提示對掃描結果進行分析，挖掘潛在信息。

📦 安裝指南

安裝要求

• Python 3.10 及以上版本。
• 安裝 python-libnmap 庫。
• 系統中已安裝 nmap。

安裝命令

安裝 python-libnmap：

pip install python-libnmap

安裝 nmap：

# 在 Debian/Ubuntu 上
sudo apt-get install nmap

# 在 Fedora/CentOS 上
sudo dnf install nmap

💻 使用示例

啟動服務器

從源代碼啟動

python -m src.nmap_mcp

安裝包後啟動

pip install -e .
nmap-mcp

可用工具

run-nmap-scan

• 功能：在指定目標上運行 nmap 掃描。
• 參數：
  • target：目標主機或網絡（例如 192.168.1.1 或 192.168.1.0/24）。
  • options：nmap 選項（例如 -sV -p 1-1000）。

get-scan-details

• 功能：獲取特定掃描的詳細信息。
• 參數：
  • scan_id：要檢索的掃描 ID。

list-all-scans

• 功能：列出所有可用的掃描結果。
• 參數：無。

可用提示

analyze-scan

• 功能：分析 nmap 掃描結果。
• 參數：
  • scan_id：要分析的掃描 ID。
  • focus：分析焦點（安全/服務/概述）。

資源

掃描結果以帶有 nmap://scan/{scan_id} URI 方案的資源形式提供。

示例工作流程

1. 運行掃描

調用工具：run-nmap-scan
參數：{"target": "192.168.1.0/24", "options": "-sV -p 22,80,443"}

2. 獲取掃描詳細信息

調用工具：get-scan-details
參數：{"scan_id": "<上一步驟中的 scan_id>"}

3. 列出所有掃描

調用工具：list-all-scans

4. 分析掃描結果

獲取提示：analyze-scan
參數：{"scan_id": "<scan_id>", "focus": "安全"}

📚 詳細文檔

安全注意事項

⚠️ 重要提示

此服務器會在您的系統上執行 nmap 命令。請謹慎掃描您沒有所有權或未獲得許可的網絡，因為未經授權的掃描在某些司法管轄區可能是非法的。

故障排除

若遇到與 nmap 未找到或執行錯誤相關的問題，可按以下步驟排查：

1. 確保已安裝 nmap 並且其在系統的 PATH 中可用。
2. 檢查日誌以查看正在使用的 nmap 可執行文件。
3. 服務器會嘗試使用完整的 nmap 路徑以避免衝突。

Docker 使用

你可以將 MCP 服務器運行在 Docker 容器中，具體操作如下：

# 構建 Docker 鏡像
docker build -t nmap-mcp-server .

# 運行 Docker 容器
docker run -it --rm nmap-mcp-server

與 Glama MCP 目錄集成後，Docker 容器能讓其他人無需擔心安裝依賴項即可輕鬆使用此 MCP 服務器。

📄 許可證

本項目採用 MIT 許可證，具體內容請參閱 LICENSE 文件。