🚀 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 社区提供的宝贵工具和技术支持。