🚀 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 即可获得无缝安装体验。
手动安装
- 克隆仓库：
git clone https://github.com/yourusername/nmapmcp.git
cd nmapmcp
- 安装依赖项：
安装
uv工具以运行项目：
npm install uv
- 创建虚拟环境（可选）：
uv init
uv run
- 安装依赖项：
npm install
📚 详细文档
配置
编辑 claude_desktop_config.json 文件以自定义设置：
{
"configuration": {
"nmap_path": "/path/to/nmap",
"mcp_endpoint": "http://localhost:8080"
}
}
贡献指南
- 克隆仓库：
git clone https://github.com/yourusername/nmapmcp.git
cd nmapmcp
- 创建分支：
git checkout -b feature/new-feature
- 提交更改：
git add .
git commit -m "添加新功能"
git push origin feature/new-feature
- 提出拉取请求：访问原始仓库 NmapMCP，点击“New Pull Request”以提交更改。
📄 许可证
该项目采用 MIT 许可证。
致谢
特别感谢 Nmap 和 MCP 社区提供的宝贵工具和技术支持。