netops-mcp: primeiro ping, depois falar em varrer

Para quem

Se quiser ligar ping, traceroute, mtr, nmap, DNS, HTTP e monitorização de sistema a um cliente MCP, este serviço serve. O texto oficial descreve-o como um servidor que expõe 26 ferramentas de diagnóstico de rede e sistema, e nomeia Claude Desktop, Claude Code e Cursor.

Notas de protocolo:

https://modelcontextprotocol.io/

Serve a quem já consegue clonar um repositório, usar uv e correr Linux ou macOS. O texto oficial exige Python 3.10 ou mais recente. As ferramentas de rede estão ligadas ao sistema operativo e não suportam Windows.

Não serve a quem procura um caminho substituto no Windows, nem a quem faz nmap a um alvo público à primeira. Uma varredura sonda ativamente um anfitrião remoto; há uma fronteira operacional e de conformidade.

Repositório oficial:

https://github.com/alpadalar/netops-mcp

Primeira tentativa em 3 minutos

Há só um caminho oficial recomendado: depois de clonar, criar um ambiente com uv e fazer uma instalação editável. Não procurar outro instalador e não passar ao modo HTTP na primeira vez.

git clone https://github.com/alpadalar/netops-mcp.git
cd netops-mcp
uv venv
source .venv/bin/activate
uv pip install -e .

Endereço de clone:

https://github.com/alpadalar/netops-mcp.git

Pré-requisitos: Python >= 3.10, uv, Linux ou macOS. Esta página não escreve em sequência uma linha de arranque stdio. Após instalar, escrever no cliente a entrada que esse ambiente fornece; não inventar um comando.

Notas uv:

https://github.com/astral-sh/uv

Depois de ligar, uma chamada de baixo risco: usar o ping já confirmado e enviar sondas só a um anfitrião que tenha direito a sondar. Não chamar nmap nem ligar o modo HTTP. ping sai à rede como pacotes.

Sucesso: regressam resultados de sonda, sem varredura de portos nem escuta HTTP. Se a instalação falhar, verificar primeiro se está em Linux/macOS e se o uv está disponível.

Casos de uso

Caso 1: conectividade. O objeto é ping; o mesmo grupo também tem traceroute, mtr, telnet, netcat. Na primeira vez, só ping. As fontes não têm tabela de parâmetros; o sucesso é regressar saída de sonda. Não sondar alvos não autorizados.

Caso 2: consulta DNS. Os objetos são nslookup, dig, host. É outra classe de consulta somente leitura. Consultar só domínios que já conhece. Não misturar isto com o grupo HTTP curl, httpie, api_test como primeiro passo. As fontes não têm o detalhe de encapsulamento das funções; usar só as ferramentas DNS que o cliente mostra de facto.

Limites de uso

O modo HTTP precisa por omissão de uma chave de interface; sem chave recusa arrancar. Notas de autenticação:

https://github.com/alpadalar/netops-mcp#authentication

Esse não é o caminho da primeira vez. nmap e a monitorização de sistema leem ou sondam mais informação. O ponto de confirmação é aceitar o âmbito de sonda e que métricas locais entrarão na conversa, e só então agir. Não inventar endereços de escuta, variáveis de chave ou contornos Windows não nomeados. O texto oficial não escreve passos de desinstalação.