ONOS MCP Servidor

ONOS MCP Server

Overview

Una implementació del servidor Model Context Protocol (MCP) que ofereix capacitats de control i gestió de xarxes a través del controlador SDN ONOS. Aquest servidor permet als assistents d’IA accedir a la gestió de xarxes ONOS, al control d’aparells OpenFlow i a anàlisis exhaustives mitjançant una interfície API estructurada. És ideal per a entorns educatius, operacions de xarxa, investigació SDN i gestió de xarxes assistida per IA.

Features

Network Resources

El servidor proporciona accés als punts finals de l’API REST d’ONOS, incloent:

Dispositius de xarxa, enllaços i hosts
Informació de topologia
Regles de flux i intents
Aplicacions i serveis
Estadístiques i mètriques
Salut del sistema i del clúster

Analytics Tools

Network Summary: Obteniu una visió completa dels dispositius, enllaços, hosts i clústers amb informació detallada dels dispositius
Network Analytics: Analitzeu mètriques de rendiment, patrons de trànsit i estadístiques d’utilització
System Health: Monitoritzeu l’ús de memòria, l’estat del clúster i la salut dels components
Application Management: Instal·leu, activeu, desactiveu i desinstal·leu aplicacions ONOS
Flow Configuration: Creeu i gestioneu regles de flux i intents
Path Computation: Trobeu els camins òptims entre els punts finals de la xarxa

Specialized Prompts

Network Diagnostics: Diagnostiqueu problemes de connectivitat i degradació del servei
Intent-Based Configuration: Implementeu objectius de connectivitat i polítiques
Network Health Analysis: Genereu informes d’estat exhaustius
QoS Configuration: Configureu la priorització del trànsit i els nivells de servei
Performance Optimization: Milloreu l’assignació de recursos i l’escalabilitat

Requirements

Python 3.7+
uv per a la gestió de dependències
Controlador ONOS en execució
llibreria httpx
llibreria mcp

Configuration

Configureu el servidor mitjançant variables d’entorn:

ONOS_API_BASE: URL base per a l’API d’ONOS (per defecte: http://localhost:8181/onos/v1)
ONOS_USERNAME: Nom d’usuari per a l’autenticació a l’API d’ONOS (per defecte: onos)
ONOS_PASSWORD: Contrasenya per a l’autenticació a l’API d’ONOS (per defecte: rocks)

Usage with 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"
      }
    }
  }
}

Contributing

Les contribucions són benvingudes! No dubteu a enviar pull requests, informar d’errors o suggerir noves funcionalitats.