Advertise
MCP.so
Sign In

ONOS MCP Server

@davidlin2k

Repository

Basic information

Category

Other

License

GPL-3.0

Transports

stdio

Author

davidlin2k

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

1

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.

2

How do I configure authentication to the ONOS controller?

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

3

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.

4

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.

5

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

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Soar Flight Booking MCP

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

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Advertise