ONOS
About
Enables network management and control for ONOS by providing comprehensive REST API access to network topology, device configuration, flow management, and system diagnostics for software-defined networking research and prototyping.
Details
- Author
- davidlin2k
- Repository
- davidlin2k/onos-mcp-server
- GitHub stars
- 2
- Downloads
- 108
- License
- GNU General Public License v3.0
- Categories
- Cloud Service, Infrastructure, Developer Tools, Search, API, Other
- Tags
- #data-science, #analytics
Jump to
- Access network devices, links, hosts, and topology
- Manage flow rules, intents, and applications
- Retrieve statistics, metrics, and cluster health
- Perform network summary and performance analytics
- Compute optimal paths between network endpoints
- Install, activate, deactivate, and uninstall ONOS applications
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
ONOSCommand (node, npx, python, etc.)uvArguments-
Argument 1
--directory -
Argument 2
parent_of_servers_repo/servers/src/onos-mcp-server -
Argument 3
run -
Argument 4
server.py
Environment-
ONOS_API_BASE
http://localhost:8181/onos/v1 -
ONOS_PASSWORD
rocks -
ONOS_USERNAME
onos
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server using environment variables:
- ONOS_API_BASE: Base URL for ONOS API (default: http://localhost:8181/onos/v1)
- ONOS_USERNAME: Username for ONOS API authentication (default: onos)
- ONOS_PASSWORD: Password for ONOS API authentication (default: rocks)
{
"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"
}
}
}
}
Network Summary
Get a comprehensive overview of devices, links, hosts, and clusters with detailed device information.
Network Analytics
Analyze performance metrics, traffic patterns, and utilization statistics.
System Health
Monitor memory usage, cluster status, and component health.
Application Management
Install, activate, deactivate, and uninstall ONOS applications.
Flow Configuration
Create and manage flow rules and intents.
Path Computation
Find optimal paths between network endpoints.
Network Diagnostics
Troubleshoot connectivity issues and service degradation.
Intent-Based Configuration
Implement connectivity objectives and policies.
Network Health Analysis
Generate comprehensive status reports.
QoS Configuration
Set up traffic prioritization and service levels.
Performance Optimization
Improve resource allocation and scalability.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"onos": {
"env": {
"ONOS_API_BASE": "http://localhost:8181/onos/v1",
"ONOS_PASSWORD": "rocks",
"ONOS_USERNAME": "onos"
},
"args": [
"--directory",
"parent_of_servers_repo/servers/src/onos-mcp-server",
"run",
"server.py"
],
"command": "uv"
}
}
}Linux
{
"env": {
"ONOS_API_BASE": "http://localhost:8181/onos/v1",
"ONOS_PASSWORD": "rocks",
"ONOS_USERNAME": "onos"
},
"args": [
"--directory",
"parent_of_servers_repo/servers/src/onos-mcp-server",
"run",
"server.py"
],
"command": "uv"
}Macos
{
"env": {
"ONOS_API_BASE": "http://localhost:8181/onos/v1",
"ONOS_PASSWORD": "rocks",
"ONOS_USERNAME": "onos"
},
"args": [
"--directory",
"parent_of_servers_repo/servers/src/onos-mcp-server",
"run",
"server.py"
],
"command": "uv"
}Windows
{
"env": {
"ONOS_API_BASE": "http://localhost:8181/onos/v1",
"ONOS_PASSWORD": "rocks",
"ONOS_USERNAME": "onos"
},
"args": [
"--directory",
"parent_of_servers_repo/servers/src/onos-mcp-server",
"run",
"server.py"
],
"command": "uv"
}An MCP server for managing ONOS (Open Network Operating System) networks.
A Model Context Protocol (MCP) server implementation that provides network control and management capabilities through the ONOS SDN controller. This server enables AI assistants to access ONOS network management, OpenFlow device control, and comprehensive analytics through a structured API interface. The server is ideal for educational environments, network operations, SDN research, and AI-assisted network management.
The server provides access to ONOS REST API endpoints, including:
- Network devices, links, and hosts
- Topology information
- Flow rules and intents
- Applications and services
- Statistics and metrics
- System and cluster health
- Network Summary: Get a comprehensive overview of devices, links, hosts, and clusters with detailed device information
- Network Analytics: Analyze performance metrics, traffic patterns, and utilization statistics
- System Health: Monitor memory usage, cluster status, and component health
- Application Management: Install, activate, deactivate, and uninstall ONOS applications
- Flow Configuration: Create and manage flow rules and intents
- Path Computation: Find optimal paths between network endpoints
- Network Diagnostics: Troubleshoot connectivity issues and service degradation
- Intent-Based Configuration: Implement connectivity objectives and policies
- Network Health Analysis: Generate comprehensive status reports
- QoS Configuration: Set up traffic prioritization and service levels
- Performance Optimization: Improve resource allocation and scalability
- Python 3.7+
- uvfor dependency management
- Running ONOS controller
- httpx library
- mcp library
Configure the server using environment variables:
- ONOS_API_BASE: Base URL for ONOS API (default:http://localhost:8181/onos/v1)
- ONOS_USERNAME: Username for ONOS API authentication (default: onos)
- ONOS_PASSWORD: Password for ONOS API authentication (default: rocks)
{ "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" } } } }
Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest new features.
A comprehensive MCP server for configuring and managing Cisco ACI (Application Centric Infrastructure) fabrics through the APIC REST API.
An MCP server that enables LLMs to interact with Cisco Intersight APIs.
Official Cisco MCP server for connecting AI agents to Meraki's cloud-managed networking solutions.
An MCP server for Cisco NSO (Network Services Orchestrator) that exposes NSO data and operations as MCP primitives.
Access Cisco Support APIs for bug searches and other support-related tasks.
Interact with the Illumio Policy Compute Engine (PCE) to manage workloads, labels, and analyze traffic flows.
A Python-based MCP server for Cisco's Meraki Dashboard, providing tools to query the API for discovering, monitoring, and managing your Meraki environment.
Integrate with Tailscale's CLI and API for automated network management and monitoring.
The Fabric MCP server exposes the following MCP tools that allow AI assistants to interact with your Equinix Fabric resources. Each tool corresponds to a specific Fabric API endpoint.
An MCP server for Cisco NSO that exposes its data and operations as MCP primitives.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
