Onos Mcp Server

@ortega-kb

a month ago

Model Context Protocol (MCP) for the ONOS SDN controller. This server exposes the network state (topology, flows, statistics) to AI agents, facilitating automation and intelligent monitoring of SDN networks.

Overview Tools Comments

Overview

What is ONOS MCP Server?

The ONOS MCP Server is a Model Context Protocol (MCP) server implementation built with Java 21 and Spring Boot. It provides a professional bridge to the ONOS SDN controller, allowing AI models to manage network infrastructure, control OpenFlow devices, and access real-time network analytics through a secure REST API.

How to use ONOS MCP Server?

Build: Clone the repository and run ./mvnw clean install to generate the JAR.
Configure: Set your ONOS URL and credentials in src/main/resources/application.yaml or via environment variables (ONOS_CONTROLLER_HOST, etc.).
Run: Start the server using java -jar target/onos-mcp-server-0.0.1-SNAPSHOT.jar.
Connect: Add the server configuration to your MCP client (Claude Desktop, Antigravity, etc.) using the JSON snippet provided in the main README.

Key features of ONOS MCP Server?

Application Control: Dynamically list, activate, and deactivate ONOS applications.
Infrastructure Inventory: Full visibility into switches, routers, and network topology.
Host Tracking: Monitor end-node locations, IP addresses, and MAC associations.
Flow Management: Programmatically add, remove, and list network flow rules.
Production Ready: High-performance implementation using Spring Cloud OpenFeign and Spring AI.

Use cases of ONOS MCP Server?

Enterprise SDN Automation: Managing large-scale network configurations with AI assistance.
Rapid Prototyping: Developing and testing new network flow logic using natural language.
Network Observability: Real-time monitoring and diagnosis of network anomalies by AI agents.
Academic Research: Platform for testing Software-Defined Networking concepts and AI-driven orchestration.

FAQ

What programming language is ONOS MCP Server written in? It is written in Java 21 using the Spring Boot framework.

Is there a license for using ONOS MCP Server? Yes, it is licensed under the MIT License, which allows for free use, modification, and redistribution.

What are the requirements to run ONOS MCP Server? You need Java 21 (JDK), Maven (wrapper included), and an accessible ONOS Controller (v2.x or higher) with REST API access.

Build with ShipAny.