MCP NMAP 服务器

一个模型上下文协议 (MCP) 服务器，使 AI 助手能够使用 NMAP 执行网络扫描操作。该服务器为 AI 模型提供了一个与 NMAP 交互的标准化接口，从而可以通过 AI 对话执行网络分析和安全评估。

前提条件

• Windows 操作系统
• Node.js (v18 或更高版本)
• 已安装 NMAP 且可从 Windows 命令行访问
• TypeScript 用于开发

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 NMAP 服务器：

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

手动安装

使用 npm 全局安装该软件包：

npm install -g mcp-nmap-server

或者在您的项目中本地安装：

npm install mcp-nmap-server

功能

该服务器通过一个简单的接口提供对 NMAP 核心功能的访问。它支持快速扫描、完整端口扫描、版本检测和自定义计时模板。该实现使用 NMAP 的原生命令行界面，确保与标准 NMAP 操作的可靠性和一致性。

使用 Claude Desktop 进行配置

要在 Windows 上将此服务器与 Claude Desktop 一起使用，您需要在位于以下位置的 Claude 配置文件中对其进行配置： C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\config.json

通过将其添加到 mcpServers 部分，将 NMAP 服务器添加到您的配置中。这是一个完整的 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 一起使用

配置完成后，像 Claude 这样的 AI 助手可以通过 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 的对话示例：

Human: 你能扫描 localhost 的开放端口吗？

Claude: 我将帮助您使用 NMAP 扫描 localhost。

<runs nmap scan with parameters>
target: "localhost"
scanType: "quick"
timing: 3

许可证

MIT 许可证

支持

如有问题、建议或贡献，请访问 GitHub 存储库。