NmapMCP

NmapMCP 是一款将强大的网络扫描工具 Nmap 与模型上下文协议（MCP）相结合的集成工具，能够在 MCP 兼容环境中实现无缝的网络扫描功能。该项目让用户可以直接通过 MCP 接口执行多种网络扫描任务，如热门端口扫描、DNS 暴力破解等。

功能

• 热门端口扫描：快速识别目标主机上最常用的端口，评估潜在入侵点。
• 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 社区提供的宝贵工具和技术支持。