项目简介

Nmap MCP服务器是一个基于Model Context Protocol的工具服务器，它将强大的Nmap网络扫描工具的功能通过标准化的接口暴露给AI客户端使用。用户可以通过AI助手直接执行各种网络扫描任务，无需手动输入复杂的命令行参数。

主要功能

• 基础扫描：提供快速、全面和隐蔽三种扫描模式
• 服务检测：识别目标主机上运行的服务及其版本信息
• 系统识别：检测目标主机的操作系统类型
• 脚本扫描：运行Nmap脚本引擎进行高级侦察和漏洞评估
• 端口扫描：支持SYN、Connect和UDP等多种扫描方式
• 漏洞扫描：执行专门的漏洞检测脚本
• 网络发现：自动发现网络中的活动主机和服务
• 自定义扫描：支持用户自定义Nmap参数，满足特殊需求

安装步骤

1. 安装Python 3.10或更高版本
2. 安装Nmap工具：
   • macOS: 'brew install nmap'
   • Ubuntu/Debian: 'sudo apt install nmap'
   • Windows: 从nmap.org官网下载安装
3. 获取项目代码：
   • 下载或克隆仓库到本地目录
4. 安装依赖：
   • 进入项目目录执行：'pip install -e .'

服务器配置

在您的AI助手（如Claude Desktop）的MCP设置中添加以下配置：

{
  "mcpServers": {
    "NmapMCP": {
      "command": "python",
      "args": ["/path/to/your/server.py"]
    }
}

配置说明：

• server name: NmapMCP（可自定义）
• command: python（Python解释器）
• args: 填写server.py文件的完整路径

基本使用方法

配置完成后，您可以在AI助手中直接使用以下类型的命令：

• "扫描192.168.1.0/24网段的所有活动主机"
• "检测example.com网站运行的服务和版本"
• "对目标主机进行漏洞扫描评估"
• "使用自定义参数执行特殊扫描任务"

服务器会自动处理复杂的Nmap命令生成和执行，您只需提供简单的目标地址和扫描类型即可。