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 倉庫。