Nexus Dashboard MCP Server

A comprehensive Model Context Protocol (MCP) server for Cisco Nexus Dashboard, enabling AI agents like Claude to interact with Nexus Dashboard APIs for intelligent network automation and management.

Features

Core Capabilities

• Complete API Coverage: Access to 638+ operations across 5 Nexus Dashboard APIs

  • Manage API (146 endpoints): Fabrics, switches, VLANs, VRFs, networks, interfaces
  • Analyze API: Telemetry, insights, anomalies, compliance
  • Infrastructure API: System health, licensing, user management
  • OneManage API: Device inventory, topology
  • Orchestration API: Workflows and automation

• Security First:

  • HTTPS with self-signed certificates (auto-generated)
  • Multi-user authentication with role-based access control (RBAC)
  • Read-only mode by default with explicit edit mode enablement
  • Fernet-encrypted credential storage
  • Complete audit logging with client IP tracking
  • Granular operation whitelisting per role

• Web Management UI:

  • Next.js-based management interface with HTTPS
  • User and role management
  • Real-time system health monitoring
  • Audit log viewer with CSV export
  • Cluster management with connection testing
  • Security configuration dashboard
  • API guidance and workflow management

• Enterprise Ready:

  • PostgreSQL database for persistence
  • Docker-based deployment with host networking
  • Complete audit trail for compliance
  • LDAP integration support

Quick Start

Prerequisites

• Docker 20.10+ and Docker Compose 2.0+
• Cisco Nexus Dashboard 4.1+ with NDFC 12.x
• Node.js 18+ (for remote MCP access via mcp-remote)

1. Clone and Configure

git clone https://github.com/beye91/nexus-dashboard-mcp.git
cd nexus-dashboard-mcp

# Create environment file with your server's IP address
echo "CERT_SERVER_IP=YOUR_SERVER_IP" > .env

Replace YOUR_SERVER_IP with your server’s actual IP address (e.g., 192.168.1.213).

2. Start Services

docker compose up -d --build

This will:

• Generate self-signed SSL certificates automatically
• Start PostgreSQL database (port 15432)
• Start Web API with HTTPS (port 8444)
• Start Web UI with HTTPS (port 7443)
• Start MCP Server for Claude integration

3. Initial Setup

1. Open your browser and navigate to:

   https://YOUR_SERVER_IP:7443
   

2. Accept the self-signed certificate warning

3. Complete the initial admin setup:

   • Username: admin
   • Email: [email protected]
   • Password: Admin123! (or your preferred password)