NMAP Scanner

🚀 MCP NMAP 服务器

MCP NMAP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它为 AI 助手提供了使用 NMAP 执行网络扫描操作的能力。借助该服务器，AI 模型可通过标准化接口与 NMAP 交互，进而实现网络分析和安全评估，让网络扫描在 AI 对话中变得更加便捷高效。

🚀 快速开始

MCP NMAP 服务器能让 AI 助手轻松使用 NMAP 进行网络扫描。在使用前，需确保满足先决条件，并完成相应的安装与配置。

✨ 主要特性

• 提供访问 NMAP 核心功能的简单接口。
• 支持快速扫描、完整的端口扫描、版本检测和自定义时间模板。
• 使用 NMAP 本机命令行界面，确保可靠性和与标准 NMAP 操作的一致性。

📦 安装指南

先决条件

• Windows 操作系统
• Node.js（v18 或更高版本）
• NMAP 已安装并可在 Windows 命令行中使用
• 使用 TypeScript 进行开发

安装方式

通过 Smithery 自动安装

要自动通过 Smithery 安装 NMAP 服务器用于 Claude Desktop，可执行以下命令：

npx -y @smithery/cli install mcp-nmap-server --client claude

手动安装

可使用 npm 进行全局安装或在项目中本地安装：

• 全局安装：

npm install -g mcp-nmap-server

• 本地安装：

npm install mcp-nmap-server

💻 使用示例

与 Claude Desktop 配置

要在 Windows 上将此服务器与 Claude Desktop 一起使用，需在 Claude 配置文件中进行配置，该文件位于：C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\config.json。通过将 NMAP 服务器添加到 mcpServers 部分来配置。以下是完整的 Claude Desktop 配置文件示例：

{
    "mcpServers": {
        "nmap": {
            "command": "node",
            "args": [
                "C:\\Users\\YOUR_USERNAME\\Downloads\\mcp-nmap-server\\dist\\index.js"
            ]
        }
    },
    "globalShortcut": "Ctrl+Q"
}

请替换 YOUR_USERNAME 为您的 Windows 用户名，并调整 NMAP 服务器的安装路径。

与 AI 一起使用

配置完成后，AI 助手（如 Claude）可以通过调用 run_nmap_scan 函数使用该服务器。该函数接受以下参数：

{
    target: string;            // 要扫描的目标主机或网络
    ports?: string;           // 可选端口规范（例如，“80,443”或“1-1000”）
    scanType?: 'quick' | 'full' | 'version';  // 扫描类型（默认：'quick'）
    timing?: number;          // NMAP 时间模板 0 - 5（默认：3）
    additionalFlags?: string; // 可选的额外 NMAP 标志
}

与 Claude 对话示例：

人类：你能扫描本地主机上的开放端口吗？

Claude：我将帮助您使用 NMAP 扫描本地主机。

<执行目标为 localhost、类型为 quick、时间设为 3 的 nmap 扫描>

📄 许可证

本项目采用 MIT License。

📚 详细文档

有关问题、建议或贡献，请访问 GitHub 仓库。