Nmapmcp

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