SDWAN

The SD-WAN MCP Server provides a Python-based MCP service that exposes REST-like endpoints to monitor and manage SD-WAN devices. It includes features for device discovery, statistics collection (interface stats, device counters, tunnel stats), BFD monitoring, configuration retrieval, health analytics, and session management. When integrated with Cursor or other MCP-enabled tools, you can query for specific devices, retrieve real-time metrics, or generate comprehensive network reports using the provided tools. The server authenticates against the SD-WAN management server and offers async capabilities for non-blocking operations, ensuring responsive querying and monitoring across multiple devices. Available tools cover a broad spectrum—from basic device enumeration and monitoring to advanced analytics like health summaries, top interfaces by traffic, and network-wide alerts.

Prerequisites:

• Python 3.8 or higher
• Access to the SD-WAN management server
• Cursor IDE (for integration)

Installation steps:

1. Clone the repository

   git clone https://github.com/yourusername/sdwan-mcp-server.git
   cd sdwan-mcp-server
   

2. Install dependencies

   pip install -r requirements.txt
   

3. Configure environment variables

   # Copy the example environment file (if provided)
   # cp .env.example .env
   # Edit .env with your settings
   

4. Update configuration Edit your environment variables (see .env or the README for required keys):

   • SDWAN_BASE_URL: SD-WAN server base URL
   • SDWAN_USERNAME: Authentication username
   • SDWAN_PASSWORD: Authentication password
   • VERIFY_SSL: Enable/disable SSL verification
   • LOG_LEVEL: Logging level (DEBUG, INFO, WARNING, ERROR)
   • SESSION_TIMEOUT: Session timeout in seconds
   • AUTO_RECONNECT: Auto-reconnect on session expiry

5. Test the server

   python test_client.py
   

6. Run the server

   python main.py
   

Tips and common considerations:

• Ensure SD-WAN_BASE_URL points to the correct management server IP and port (default 8443). If using self-signed certificates, consider VERIFy_SSL=false during testing, but enable SSL verification in production.
• Keep SDWAN_USERNAME and SDWAN_PASSWORD secure; use environment-based configuration instead of hard-coding.
• Cursor integration requires the MCP configuration to reference the correct path to main.py and proper environment variables. Use absolute paths for reliability.
• The server exposes a broad set of tools; start with basic monitoring commands (get_fabric_devices, get_device_monitor) to verify connectivity before enabling analytics like get_device_health_summary or generate_network_report.
• If you encounter authentication errors, verify that SESSION_TIMEOUT and AUTO_RECONNECT are set according to your session lifecycle preferences.
• Review API endpoints in the README to map MCP actions to your Cursor queries or external tooling.