SD-WAN MCP Server

A comprehensive Model Context Protocol (MCP) server for monitoring and managing SD-WAN devices through REST API endpoints. This server exposes SD-WAN device monitoring and management functionality that can be integrated with Cursor and other MCP-compatible tools.

🚀 Features

• 🔧 Device Management: List and monitor SD-WAN fabric devices
• 📊 Statistics Collection: Interface statistics, device counters, tunnel statistics
• 🔍 BFD Monitoring: Bidirectional Forwarding Detection state and sessions
• ⚙️ Configuration Access: Device configuration retrieval
• 📈 Advanced Analytics: Health summaries, traffic analysis, and alerting
• 🔐 Session Management: Automatic authentication and session handling
• ⚡ Async Support: Full async/await support for non-blocking operations
• 🎯 Cursor Integration: Seamless integration with Cursor IDE

📋 Available Tools

Basic Monitoring Tools

1. get_fabric_devices - Get list of all SD-WAN fabric devices
2. get_device_monitor - Get SD-WAN device monitoring information
3. get_device_counters - Get SD-WAN device counters and statistics
4. get_interface_statistics - Get interface statistics for all SD-WAN devices
5. get_device_config - Get SD-WAN device configuration (requires device_id)
6. get_bfd_state - Get BFD state for an SD-WAN device (requires device_id)
7. get_bfd_sessions - Get BFD sessions for an SD-WAN device (requires device_id)
8. get_tunnel_statistics - Get tunnel statistics for an SD-WAN device (requires device_id)

Authentication Tools

9. authenticate - Authenticate with the SD-WAN management server
10. get_session_status - Check current authentication session status

Advanced Analytics Tools

11. get_device_health_summary - Comprehensive health summary across all SD-WAN devices
12. filter_devices_by_status - Filter SD-WAN devices by operational status
13. get_top_interfaces_by_traffic - Get top interfaces ranked by traffic utilization
14. check_bfd_session_health - Monitor BFD session health across all SD-WAN devices
15. generate_network_report - Generate comprehensive SD-WAN network status report
16. get_device_alerts - Get alerts and warnings for SD-WAN devices by severity
17. monitor_interface_utilization - Monitor interface utilization with configurable thresholds
18. get_network_topology - Get SD-WAN network topology information

🛠️ Quick Start

Prerequisites

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

Installation

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
   cp .env.example .env
   
   # Edit .env with your settings
   nano .env
   

4. Update configuration

   ⚠️ IMPORTANT: You must update the IP address in your configuration!

   Edit your .env file:

   # REQUIRED: Change this to your SD-WAN management server IP
   SDWAN_BASE_URL="https://YOUR_SDWAN_SERVER_IP:8443"
   
   # Update credentials
   SDWAN_USERNAME="your_username"
   SDWAN_PASSWORD="your_password"
   
   # Optional settings
   VERIFY_SSL="false"
   LOG_LEVEL="INFO"
   

5. Test the server

   python test_client.py
   

6. Run the server

   python main.py
   

⚙️ Configuration

Environment Variables

... View full README on GitHub