Onos MCP Server

Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest new features.

Local serverstdioPython

What is the Onos MCP Server?

Onos mcp server lets Claude, Cursor and other MCP clients work with Onos directly. Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest new features.

What Onos does

Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest new features.

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.

Requirements

  • Python 3.7+ - uv for dependency management - Running ONOS controller - httpx library - mcp library

Practical notes

  • Maintained by davidlin2k, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Onos MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.7+ - uv for dependency management - Running ONOS controller - httpx library - mcp library
VariableDescriptionRequired
ONOS_API_BASEDeclared in the maintainer’s client configuration.Check documentation
ONOS_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
ONOS_PASSWORDDeclared in the maintainer’s client configuration.Check documentation

Frequently asked questions

Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest new features. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.