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
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.
More Other MCP servers
Awesome Mcp Servers
punkpeyeA collection of MCP servers.
Awesome-MCP-ZH
yzflyMCP 资源精选， MCP指南，Claude MCP，MCP Servers, MCP Clients
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
Mcp
browsermcpBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
Comments