Install
git clone https://github.com/alpadalar/netops-mcp.git
cd netops-mcp
uv venv
source .venv/bin/activate
uv pip install -e .Pour qui
Si vous voulez brancher ping, traceroute, mtr, nmap, DNS, HTTP et la supervision système sur un client MCP, ce service convient. Le texte officiel le décrit comme un serveur qui expose 26 outils de diagnostic réseau et système, et nomme Claude Desktop, Claude Code et Cursor.
Notes de protocole :
https://modelcontextprotocol.io/
Il convient à qui sait déjà cloner un dépôt, utiliser uv, et tourne sous Linux ou macOS. Le texte officiel exige Python 3.10 ou plus récent. Les outils réseau sont liés au système d'exploitation et ne prennent pas en charge Windows.
Il ne convient pas à qui cherche un chemin de remplacement sous Windows, ni à qui fait un nmap sur une cible publique dès le premier essai. Un scan sonde activement un hôte distant ; il y a une frontière d'exploitation et de conformité.
Dépôt officiel :
https://github.com/alpadalar/netops-mcp
Premier essai en 3 minutes
Il n'y a qu'un chemin officiel recommandé : après clonage, créer un environnement avec uv et faire une installation éditable. Ne pas chercher un autre installeur, et ne pas passer en mode HTTP la première fois.
git clone https://github.com/alpadalar/netops-mcp.git
cd netops-mcp
uv venv
source .venv/bin/activate
uv pip install -e .
Adresse de clone :
https://github.com/alpadalar/netops-mcp.git
Prérequis : Python >= 3.10, uv, Linux ou macOS. Cette page n'écrit pas de ligne de démarrage stdio à la suite. Après installation, écrire dans le client l'entrée fournie par cet environnement ; ne pas inventer de commande.
Notes uv :
https://github.com/astral-sh/uv
Une fois connecté, un appel à faible risque : utiliser le ping déjà attesté, et n'envoyer des sondes qu'à un hôte que vous avez le droit de sonder. Ne pas appeler nmap, et ne pas activer le mode HTTP. ping sort sur le réseau sous forme de paquets.
Succès : des résultats de sonde reviennent, sans scan de ports ni écoute HTTP. Si l'installation échoue, vérifier d'abord que vous êtes sous Linux/macOS et que uv est disponible.
Cas d'usage
Cas 1 : connectivité. L'objet est ping ; le même groupe a aussi traceroute, mtr, telnet, netcat. La première fois, seulement ping. Les sources n'ont pas de table de paramètres ; le succès, c'est le retour d'une sortie de sonde. Ne pas sonder des cibles non autorisées.
Cas 2 : requête DNS. Les objets sont nslookup, dig, host. C'est une autre classe de requête en lecture seule. Ne interroger que des domaines que vous connaissez déjà. Ne pas mélanger cela avec le groupe HTTP curl, httpie, api_test comme première étape. Les sources n'ont pas le détail d'emballage des fonctions ; n'utiliser que les outils DNS que le client affiche vraiment.
Limites d'usage
Le mode HTTP exige par défaut une clé d'interface ; sans clé, il refuse de démarrer. Notes d'authentification :
https://github.com/alpadalar/netops-mcp#authentication
Ce n'est pas le chemin du premier essai. nmap et la supervision système lisent ou sondent plus d'informations. Le point de confirmation est que vous acceptez la portée de sonde et que des indicateurs locaux entreront dans la conversation, puis seulement agir. Ne pas inventer d'adresses d'écoute, de variables de clé ou de contournements Windows non nommés. Le texte officiel n'écrit pas d'étapes de désinstallation.