ONOS MCP Server

@davidlin2k

Basic information

About ONOS MCP Server

A Model Context Protocol (MCP) server implementation that provides network control and management capabilities through the ONOS SDN controller.

ONOS MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "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"
      }
    }
  }
}

ONOS MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ONOS MCP Server?

A Model Context Protocol server that provides network control and management capabilities through the ONOS SDN controller, enabling AI assistants to access network devices, topology, flow rules, analytics, and applications via a structured API. It is designed for educational environments, network operations, SDN research, and AI-assisted network management.

How to use ONOS MCP Server?

Install Python 3.7+ and the required dependencies (httpx, mcp, and the uv package manager). Configure the server using environment variables (ONOS_API_BASE, ONOS_USERNAME, ONOS_PASSWORD) and run it with uv --directory <path> run server.py. Integrate with Claude Desktop by adding the provided JSON block to its MCP configuration.

Key features of ONOS MCP Server

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

Use cases of ONOS MCP Server

Network diagnostics and troubleshooting connectivity issues
Intent-based connectivity configuration and policy implementation
Comprehensive network health analysis and status reporting
QoS configuration and traffic prioritization
Performance optimization and resource allocation

Frequently asked questions

What prerequisites are needed to run the server?

Python 3.7+, the `uv` package manager, a running ONOS controller, and the `httpx` and `mcp` libraries.

How do I configure authentication to the ONOS controller?

Set the `ONOS_USERNAME` and `ONOS_PASSWORD` environment variables. Defaults are `onos` and `rocks` respectively.

What ONOS REST API endpoints does the server expose?

It provides access to endpoints for devices, links, hosts, topology, flow rules, intents, applications, statistics, and system/cluster health.

How is the server invoked in a Claude Desktop setup?

Through a JSON entry in `mcpServers` specifying `uv` as the command, the server directory, and the necessary environment variables.

What transport and authentication does the server use?

The server communicates with ONOS via HTTP (REST API) and uses basic authentication with the provided username and password.

Comments

More Other MCP servers

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

ICSS

chokcoco

不止于 CSS

20.7K