NMAP

Servidor MCP NMAP

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA realizem operações de varredura de rede usando o NMAP. Este servidor fornece uma interface padronizada para que modelos de IA interajam com o NMAP, tornando possível realizar análises de rede e avaliações de segurança por meio de conversas com IA.

Pré-requisitos

• Sistema operacional Windows
• Node.js (v18 ou superior)
• NMAP instalado e acessível pela linha de comando do Windows
• TypeScript para desenvolvimento

Instalação

Instalando via Smithery

Para instalar o Servidor NMAP para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

Instale o pacote globalmente usando npm:

npm install -g mcp-nmap-server

Ou instale localmente no seu projeto:

npm install mcp-nmap-server

Recursos

O servidor fornece acesso às funcionalidades principais do NMAP por meio de uma interface simples. Ele suporta varreduras rápidas, varreduras completas de portas, detecção de versão e modelos de temporização personalizados. A implementação usa a interface de linha de comando nativa do NMAP, garantindo confiabilidade e consistência com as operações padrão do NMAP.

Configuração com Claude Desktop

Para usar este servidor com Claude Desktop no Windows, você precisará configurá-lo no arquivo de configuração do Claude localizado em: C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\config.json

Adicione o servidor NMAP à sua configuração adicionando-o à seção mcpServers. Aqui está um exemplo completo de um arquivo de configuração do Claude Desktop:

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

Substitua YOUR_USERNAME pelo seu nome de usuário do Windows e ajuste o caminho para onde você instalou o servidor NMAP.

Uso com IA

Uma vez configurado, assistentes de IA como o Claude podem usar o servidor por meio da função run_nmap_scan. A função aceita os seguintes parâmetros:

{
    target: string;            // Host or network to scan
    ports?: string;           // Optional port specification (e.g., "80,443" or "1-1000")
    scanType?: 'quick' | 'full' | 'version';  // Scan type (default: 'quick')
    timing?: number;          // NMAP timing template 0-5 (default: 3)
    additionalFlags?: string; // Optional additional NMAP flags
}

Exemplo de conversa com Claude:

Human: Can you scan localhost for open ports?

Claude: I'll help you scan localhost using NMAP.

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

Licença

Licença MIT

Suporte

Para problemas, sugestões ou contribuições, visite o repositório do GitHub.