How waqasdaar/cisco-catalyst-sdwan-mcp works
This repository is an MCP server that lets AI clients query and, when explicitly enabled and confirmed, change Cisco Catalyst SD-WAN through vManage’s REST API; it does not connect to routers directly. The main flow is client request → tool dispatch and safeguards → API validation and vManage request → shaped response. The server also exposes dedicated fabric-health, routing, multicast, IPv6, CLI add-on, and configuration workflows. Source excerpts show the core service wiring and template-migration helpers; README statements support the broader tool capabilities.
Main entry points: server.ts MCP tool server · templateMigration.ts Template migration · vmanageApi.ts vManage API client · apiCatalog.ts API catalog
Components 19
MCP entry
- Process entry
src/index.ts - MCP tool server
src/server.ts
SD-WAN tools
- Fabric health
src/server.ts - Routing protocols
src/server.ts - Multicast tools
src/server.ts - IPv6 tools
src/server.ts - CLI add-ons
src/server.ts - UX configuration
src/server.ts - General API tools
src/services/apiCatalog.ts - Template migration
src/services/templateMigration.ts
Core services
- Variable mapping
src/services/configVariables.ts - Config review
src/services/configReview.ts - Conversion fixes
src/services/configDefects.ts - Migration state
src/services/migrationStore.ts - API catalog
src/services/apiCatalog.ts - vManage API client
src/services/vmanageApi.ts - Runtime config
src/utils/config.ts
External systems
- SD-WAN Manager
Other components
- AI MCP client
Connections 20
- AI MCP client → MCP tool server: sends tool calls
README.md - Process entry → MCP tool server: starts
src/index.ts - MCP tool server → Runtime config: loads settings
src/server.ts - MCP tool server → vManage API client: creates client
src/server.ts - MCP tool server → API catalog: creates catalog
src/server.ts - MCP tool server → Template migration: plans migration
src/server.ts - Template migration → Variable mapping: maps values
src/services/templateMigration.ts - Template migration → Config review: masks config
src/services/templateMigration.ts - Template migration → Migration state: loads and saves
src/services/templateMigration.ts - API catalog → vManage API client: validates against spec
README.md - vManage API client → SD-WAN Manager: sends REST requests
README.md - SD-WAN Manager → vManage API client: returns JSON
README.md - MCP tool server → AI MCP client: returns shaped results
README.md - AI MCP client → Fabric health: requests health
README.md - AI MCP client → Routing protocols: requests routing
README.md - AI MCP client → Multicast tools: requests multicast
README.md - AI MCP client → IPv6 tools: requests IPv6
README.md - AI MCP client → CLI add-ons: requests CLI config
README.md - AI MCP client → UX configuration: requests configuration
README.md - AI MCP client → General API tools: requests API operation
README.md