MCP NMAP服务器

这是一个基于模型上下文协议（MCP）的服务器，使AI助手能够使用NMAP执行网络扫描操作。该服务器为AI模型与NMAP的交互提供了标准化接口，使得通过AI对话即可完成网络分析和安全评估成为可能。

前提条件

• Windows操作系统
• Node.js（v18或更高版本）
• 已安装且可通过Windows命令行访问的NMAP
• 开发所需的TypeScript

安装

使用npm全局安装该包：

npm install -g mcp-nmap-server

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

npm install mcp-nmap-server

功能特性

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

与Claude Desktop的配置

要在Windows上将此服务器与Claude Desktop配合使用，您需要在Claude配置文件中进行配置，该文件位于：
C:\Users\您的用户名\AppData\Roaming\Claude\config.json

通过在mcpServers部分添加NMAP服务器来配置它。以下是一个完整的Claude Desktop配置文件示例：

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

请将您的用户名替换为您的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的示例对话：

用户：你能扫描本地主机的开放端口吗？

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

<使用以下参数运行nmap扫描>
target: "localhost"
scanType: "quick"
timing: 3

许可证

MIT许可证

支持

如需报告问题、提出建议或贡献代码，请访问GitHub仓库。