MCP

netops-mcp: primero ping, luego hablar de escanear

Para quien quiere dejar el diagnóstico de red a un agente en Linux o macOS, con Python 3.10 y uv. La primera vez, solo ping o DNS; no ejecutes nmap ni actives el modo HTTP.

Official source · netops-mcp

Install

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

Para quién

Si quieres unir ping, traceroute, mtr, nmap, DNS, HTTP y supervisión de sistema a un cliente MCP, este servicio encaja. El texto oficial lo describe como un servidor que expone 26 herramientas de diagnóstico de red y sistema, y nombra Claude Desktop, Claude Code y Cursor.

Notas de protocolo:

https://modelcontextprotocol.io/

Encaja con quien ya puede clonar un repositorio, usar uv y ejecutar Linux o macOS. El texto oficial pide Python 3.10 o más nuevo. Las herramientas de red van ligadas al sistema operativo y no admiten Windows.

No encaja quien busca una vía sustituta en Windows, ni quien hace nmap a un objetivo público a la primera. Un escaneo sondea un anfitrión remoto de forma activa; hay un límite operativo y de cumplimiento.

Repositorio oficial:

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

Primera prueba en 3 minutos

Solo hay una vía oficial recomendada: tras clonar, crear un entorno con uv y hacer una instalación editable. No busques otro instalador y no pases a modo HTTP la primera vez.

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

Dirección de clon:

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

Requisitos: Python >= 3.10, uv, Linux o macOS. Esta página no escribe en secuencia una línea de arranque stdio. Tras instalar, pon en el cliente la entrada que ofrece ese entorno; no inventes un comando.

Notas de uv:

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

Cuando estés conectado, una llamada de bajo riesgo: usa el ping ya confirmado y envía sondas solo a un anfitrión que tengas derecho a sondear. No llames nmap ni actives el modo HTTP. ping sale a la red como paquetes.

Éxito: vuelven resultados de sonda, sin escaneo de puertos ni escucha HTTP. Si la instalación falla, comprueba primero que estás en Linux/macOS y que uv está disponible.

Casos de uso

Caso 1: conectividad. El objeto es ping; el mismo grupo también tiene traceroute, mtr, telnet, netcat. La primera vez, solo ping. Las fuentes no tienen tabla de parámetros; el éxito es que vuelva salida de sonda. No sondees objetivos no autorizados.

Caso 2: consulta DNS. Los objetos son nslookup, dig, host. Es otra clase de consulta de solo lectura. Consulta solo dominios que ya conoces. No lo mezcles con el grupo HTTP curl, httpie, api_test como primer paso. Las fuentes no tienen el detalle de encapsulado de funciones; usa solo las herramientas DNS que el cliente muestra de verdad.

Límites de uso

El modo HTTP necesita por defecto una clave de interfaz; sin clave se niega a arrancar. Notas de autenticación:

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

Esa no es la vía de la primera vez. nmap y la supervisión de sistema leen o sondean más información. El punto de confirmación es que aceptas el alcance de sonda y que métricas locales entrarán en la conversación, y entonces actúas. No inventes direcciones de escucha, variables de clave ni rodeos de Windows no nombrados. El texto oficial no escribe pasos de desinstalación.