ONOS MCP Server

@davidlin2k

About ONOS MCP Server

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

Basic information

Category

Other

License

GPL-3.0

Runtime

python

Transports

stdio

Publisher

davidlin2k

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

Tools

No tools detected

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

FAQ from ONOS MCP Server

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

Maestro

Painless E2E Automation for Mobile and Web

Awesome Mcp Servers

A collection of MCP servers.

EverArt

modelcontextprotocol

Model Context Protocol Servers

🪟 Windows-MCP

MCP Server for Computer Use in Windows

AutoBrowser MCP

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser