Cisco Catalyst Sdwan Mcp Server

by stormbliss

265 downloads

Not rated

GitHub

Developer Tools

About

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.

Details

Author: stormbliss
Downloads: 265
Categories: Developer Tools

- Device management: list and monitor SD-WAN fabric devices
- Statistics collection: interface, device counters, tunnel statistics
- BFD monitoring: state and session tracking
- Configuration access: device configuration retrieval
- Advanced analytics: health summaries, traffic analysis, alerting
- Session management with automatic authentication

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Cisco Catalyst Sdwan Mcp Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

From the repository

Install the server (Python 3.8+ required), configure it with SD-WAN management server credentials, then invoke MCP tools such as get_fabric_devices, authenticate, or generate_network_report from a compatible client like Cursor IDE.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "cisco catalyst sdwan mcp server": {
            "sdwan-mcp-server": {
                "command": "python",
                "args": [
                    "/path/to/your/project/main.py"
                ],
                "env": {
                    "PYTHONPATH": "/path/to/your/project"
                }
            }
        }
    }
}

McpServers

{
    "sdwan-mcp-server": {
        "command": "python",
        "args": [
            "/path/to/your/project/main.py"
        ],
        "env": {
            "PYTHONPATH": "/path/to/your/project"
        }
    }
}

SD-WAN MCP Server

🚀 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

SD-WAN MCP Server

🚀 Features

📋 Available Tools

Basic Monitoring Tools

Authentication Tools

Advanced Analytics Tools

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright