cisco-nso-mcp-server

NSO-developer/cisco-nso-mcp-server

3.3

If you are the rightful owner of cisco-nso-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Cisco NSO MCP Server is a Model Context Protocol server implementation that integrates with Cisco's Network Services Orchestrator to enable AI-powered network automation through natural language interactions.

The Cisco NSO MCP Server is designed to facilitate seamless interaction between AI models and Cisco's Network Services Orchestrator (NSO) by exposing NSO data and operations as MCP primitives. This server allows AI models to perform network automation tasks using natural language, enhancing the efficiency and intelligence of network management. By leveraging the Model Context Protocol, the server standardizes the way AI models interact with external tools and services, ensuring interoperability across various AI frameworks. The server supports both stdio and SSE transport types, providing flexibility in communication methods. It integrates with NSO using the RESTCONF API, offering a clean and Pythonic interface for network operations. The server is highly configurable, allowing users to set connection parameters, logging preferences, and transport options through command-line arguments or environment variables.

Features

  • Stdio Transport for process-bound communication
  • Tool-First Design with clear interfaces for network operations
  • Asynchronous Processing for improved performance
  • Structured Responses with status, data, and metadata sections
  • Flexible Logging to stdout and/or file

Usages

usage with windsurf cascade uv

{
  "mcpServers": {
    "nso": {
      "command": "uvx",
      "args": [
        "cisco-nso-mcp-server",
        "--nso-address=127.0.0.1",
        "--nso-port=8080",
        "--nso-username=admin",
        "--nso-password=admin"
      ],
      "env": {
        "LOG_FILE": "/path/to/your/logs/nso-mcp.log"
      }
    }
  }
}

usage with windsurf cascade pip

{
  "mcpServers": {
    "nso": {
      "command": "/path/to/your/env/bin/cisco-nso-mcp-server",
      "args": [
        "--nso-address=127.0.0.1",
        "--nso-port=8080",
        "--nso-username=admin",
        "--nso-password=admin"
      ],
      "env": {
        "LOG_FILE": "/path/to/your/logs/nso-mcp.log"
      }
    }
  }
}

Tools

  1. get_device_ned_ids

    Retrieves Network Element Driver (NED) IDs from Cisco NSO

  2. get_device_groups

    Retrieves device groups from Cisco NSO

  3. get_device_platform

    Gets platform information for a specific device in Cisco NSO

  4. get_device_config

    Gets full configuration for a specific device in Cisco NSO

  5. get_device_state

    Gets state for a specific device in Cisco NSO

  6. check_device_sync

    Checks sync status for a specific device in Cisco NSO

  7. sync_from_device

    Syncs from a specific device in Cisco NSO