NmapMCP

NmapMCP 是 Nmap 扫描工具与模型上下文协议 (MCP) 的强大集成，可在 MCP 兼容环境中实现无缝的网络扫描功能。该项目允许用户直接通过 MCP 接口执行各种网络扫描，例如热门端口扫描、DNS 暴力破解等。

功能

• 热门端口扫描： 快速识别目标主机上最常用的端口，以评估潜在的入口点。

• DNS 暴力破解： 发现与目标域关联的子域，有助于全面的域映射。

• 列表扫描： 获取指定范围内活动主机的列表，无需端口扫描，适用于网络清单。

• 操作系统检测： 通过分析网络响应来确定目标主机的操作系统，有助于漏洞评估。

• 版本检测： 识别在开放端口上运行的服务版本，以检测过时或易受攻击的服务。

• FIN 扫描： 通过发送 FIN 数据包执行隐蔽扫描，以检测开放端口，而无需建立完整的连接。

• 空闲扫描： 通过利用空闲主机探测目标系统来执行高度隐蔽的扫描，从而最大限度地降低检测风险。

• Ping 扫描： 通过发送 ICMP 回显请求来检测网络中的活动主机，适用于网络映射。

• SYN 扫描： 执行半开放 TCP 扫描以识别开放端口，而无需完成 TCP 握手，从而降低检测的可能性。

• TCP 连接扫描： 建立完整的 TCP 连接以探测开放端口，当 SYN 扫描不可行时很有用。

• UDP 扫描： 识别目标主机上的开放 UDP 端口，以检测不使用 TCP 的服务。

• 仅端口扫描： 仅专注于扫描端口，而无需额外的宿主发现，从而简化扫描过程。

• 无端口扫描： 执行主机发现而不扫描端口，可用于识别活动主机而不探测服务。

• ARP 发现： 使用 ARP 请求识别本地网段内的活动设备，在 LAN 环境中有效。

• 禁用 DNS 解析： 执行扫描而不将 IP 地址解析为主机名，从而提高扫描速度并减少 DNS 查询流量。

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Claude Desktop 的 Nmap 集成：

npx -y @smithery/cli install @0xPratikPatil/nmapmcp --client claude

手动安装

1. 克隆存储库：

   git clone https://github.com/0xPratikPatil/NmapMCP.git
   cd NmapMCP
   

2. 安装 uv:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. 创建环境:

   uv venv
   

4. 从 pyproject.toml 安装依赖项

   uv pip install
   

   或者

   uv pip install -r pyproject.toml
   

配置

要配置 Nmap MCP 服务器，请编辑位于项目根目录中的 claude_desktop_config.json 文件。 此文件允许您设置默认扫描参数、定义 MCP 工具行为以及调整日志记录设置。

claude_desktop_config.json 示例：

{
  "mcpServers": {
    "NmapMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/NmapMCP",
        "run",
        "main.py"
      ]
    }
  }
}

贡献

欢迎贡献！ 要贡献：

1. Fork 存储库： 单击存储库页面右上角的“Fork”按钮。

2. 克隆您的 Fork：

   git clone https://github.com/0xPratikPatil/NmapMCP.git
   

3. 创建一个新分支：

   git checkout -b feature/your-feature-name
   

4. 进行更改： 实现您的功能或修复。

5. 运行测试： 确保所有测试都通过。

6. 提交更改：

   git commit -m "Add feature: your feature name"
   

7. 推送到您的 Fork：

   git push origin feature/your-feature-name
   

8. 提交 Pull Request： 导航到原始存储库，然后单击“New Pull Request”。

许可证

该项目已获得 MIT 许可证的许可。

致谢

特别感谢 Nmap 和 MCP 社区提供的宝贵工具和支持。