ONOS MCP Server

ONOS MCP Server

Descripción general

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de control y gestión de red a través del controlador SDN de ONOS. Este servidor permite a los asistentes de IA acceder a la gestión de red de ONOS, el control de dispositivos OpenFlow y análisis completos a través de una interfaz API estructurada. El servidor es ideal para entornos educativos, operaciones de red, investigación SDN y gestión de red asistida por IA.

Características

Recursos de Red

El servidor proporciona acceso a los endpoints de la API REST de ONOS, incluyendo:

• Dispositivos de red, enlaces y hosts
• Información de topología
• Reglas de flujo e intenciones
• Aplicaciones y servicios
• Estadísticas y métricas
• Salud del sistema y del clúster

Herramientas de Análisis

• Resumen de Red: Obtenga una visión general completa de dispositivos, enlaces, hosts y clústeres con información detallada de dispositivos
• Análisis de Red: Analice métricas de rendimiento, patrones de tráfico y estadísticas de utilización
• Salud del Sistema: Supervise el uso de memoria, el estado del clúster y la salud de los componentes
• Gestión de Aplicaciones: Instale, active, desactive y desinstale aplicaciones de ONOS
• Configuración de Flujos: Cree y gestione reglas de flujo e intenciones
• Cálculo de Rutas: Encuentre rutas óptimas entre endpoints de red

Prompts Especializados

• Diagnóstico de Red: Solucione problemas de conectividad y degradación del servicio
• Configuración Basada en Intenciones: Implemente objetivos y políticas de conectividad
• Análisis de Salud de Red: Genere informes de estado completos
• Configuración de QoS: Configure priorización de tráfico y niveles de servicio
• Optimización de Rendimiento: Mejore la asignación de recursos y la escalabilidad

Requisitos

• Python 3.7+
• uv para la gestión de dependencias
• Controlador ONOS en ejecución
• librería httpx
• librería mcp

Configuración

Configure el servidor utilizando variables de entorno:

• ONOS_API_BASE: URL base para la API de ONOS (predeterminado: http://localhost:8181/onos/v1)
• ONOS_USERNAME: Nombre de usuario para la autenticación de la API de ONOS (predeterminado: onos)
• ONOS_PASSWORD: Contraseña para la autenticación de la API de ONOS (predeterminado: rocks)

Uso con 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"
      }
    }
  }
}

Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar solicitudes de extracción (pull requests), informar errores o sugerir nuevas funciones.