tariqsheikhsw/cisco-sdwan-mcp-server

本页由 AI 翻译，技术细节请以原文为准。查看原文

0 stars 7 forks 质量 67 趋势 0MIT

A comprehensive Model Context Protocol (MCP) server for monitoring and managing SD-WAN devices through REST API endpoints.

概览

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. - : List and monitor SD-WAN fabric devices - : Interface statistics, device counters, tunnel statistics - : Bidirectional Forwarding Detection state and sessions - : Device configuration retrieval - : Health summaries, traffic analysis, and alerting - : Automatic authentication and session handling - : Full async/await support for non-blocking operations - : Seamless integration with Cursor IDE 1. - Get list of all SD-WAN fabric devices 2. - Get SD-WAN device monitoring information 3. - Get SD-WAN device counters and statistics 4. - Get interface statistics for all SD-WAN devices 5. - Get SD-WAN device configuration (requires device_id) 6. - Get BFD state for an SD-WAN device (requires device_id) 7.

README

以下为原文 README 节选，完整内容请查看原文。

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

get_fabric_devices - Get list of all SD-WAN fabric devices
get_device_monitor - Get SD-WAN device monitoring information
get_device_counters - Get SD-WAN device counters and statistics
get_interface_statistics - Get interface statistics for all SD-WAN devices
get_device_config - Get SD-WAN device configuration (requires device_id)
get_bfd_state - Get BFD state for an SD-WAN device (requires device_id)
get_bfd_sessions - Get BFD sessions for an SD-WAN device (requires device_id)
get_tunnel_statistics - Get tunnel statistics for an SD-WAN device (requires device_id)

Authentication Tools

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

Advanced Analytics Tools

get_device_health_summary - Comprehensive health summary across all SD-WAN devices
filter_devices_by_status - Filter SD-WAN devices by operational status
get_top_interfaces_by_traffic - Get top interfaces ranked by traffic utilization
check_bfd_session_health - Monitor BFD session health across all SD-WAN devices
generate_network_report - Generate comprehensive SD-WAN network status report
get_device_alerts - Get alerts and warnings for SD-WAN devices by severity
monitor_interface_utilization - Monitor interface utilization with configurable thresholds
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

Clone the repository

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

Install dependencies
```
pip install -r requirements.txt
```

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
     "mcpServers": {
       "sdwan-mcp-server": {
         "command": "python",
         "args": ["/full/path/to/your/project/main.py"],
         "env": {
           "SDWAN_BASE_URL": "https://your-sdwan-server:8443",
           "SDWAN_USERNAME": "admin",
           "SDWAN_PASSWORD": "your_password"
         }
       }
     }
   }