ONOS MCP Server

Vue d'ensemble

Une implémentation de serveur Model Context Protocol (MCP) qui fournit des capacités de contrôle et de gestion de réseau à travers le contrôleur SDN d'ONOS. Ce serveur permet aux assistants IA d'accéder à la gestion du réseau ONOS, au contrôle des équipements OpenFlow, et à des analyses complètes à travers une interface API structurée. Le serveur est idéal pour les environnements éducatifs, les opérations réseau, la recherche SDN, et la gestion de réseau assistée par l'IA.

Caractéristiques

Ressources réseau

Le serveur fournit un accès aux points d'extrémité de l'API REST d'ONOS, y compris :

• Dispositifs réseau, liens et hôtes
• Informations sur la topologie
• Règles de flux et intentions
• Applications et services
• Statistiques et métriques
• Santé du système et de la grappe

Outils d'analyse

• Résumé du réseau: Obtenez une vue d'ensemble des périphériques, des liens, des hôtes et des clusters avec des informations détaillées sur les périphériques
• Analyse du réseau: Analyse des mesures de performance, des modèles de trafic et des statistiques d'utilisation
• Santé du système: Surveillez l'utilisation de la mémoire, l'état des clusters et la santé des composants
• Gestion des applications: Installer, activer, désactiver et désinstaller les applications ONOS
• Configuration des flux: Créer et gérer les règles de flux et les intentions
• Calcul des chemins: Trouver des chemins optimaux entre les points d'extrémité du réseau

Invites spécialisées

• Diagnostic du réseau: Dépannage des problèmes de connectivité et de dégradation des services
• Configuration basée sur les intentions: Mise en œuvre d'objectifs et de politiques de connectivité
• Analyse de la santé du réseau: Générer des rapports d'état complets
• Configuration de la qualité de service (QoS) : Mise en place de la priorisation du trafic et des niveaux de service
• Optimisation des performances: Amélioration de l'allocation des ressources et de l'évolutivité

Exigences

• Python 3.7+
• uv pour la gestion des dépendances
• Contrôleur ONOS en fonctionnement
• bibliothèque httpx
• bibliothèque mcp

Configuration du serveur

Configurer le serveur en utilisant les variables d'environnement :

• ONOS_API_BASE: URL de base pour l'API ONOS (par défaut : http://localhost:8181/onos/v1)
• ONOS_USERNAME: Nom d'utilisateur pour l'authentification de l'API ONOS (par défaut : onos)
• ONOS_PASSWORD: Mot de passe pour l'authentification de l'API ONOS (par défaut : rocks)

Utilisation avec Claude Desktop

{ "mcpServers" : { "onos" : { "command" : "uv", "args" : [ "--directory", "parent_of_servers_repo/servers/src/onos-mcp-server", "run", "server.py" ], "env" : { "ONOS_API_BASE" : "http://localhost:8181/onos/v1", "ONOS_USERNAME" : "onos", "ONOS_PASSWORD" : "rocks" } } }

Contribuer

Les contributions sont les bienvenues ! N'hésitez pas à soumettre des demandes d'extension, à signaler des bogues ou à suggérer de nouvelles fonctionnalités.