Zyxel Switch MCP Server

A comprehensive Model Context Protocol (MCP) server for Zyxel switch CLI commands, enabling AI applications to interact with Zyxel switches for network configuration, monitoring, and management operations.

✅ PRODUCTION READY: Real Zyxel CLI Commands Integrated

This MCP server now contains authentic Zyxel CLI commands and response formats extracted from official Zyxel documentation (407-page CLI Reference Guide). All mock implementations have been replaced with real command syntax.

Features

• ✅ Real CLI Command Support: Authentic Zyxel switch CLI commands from official documentation
• ✅ Production-Ready Responses: Actual command output formats for GS1920/GS1900/XGS series
• ✅ Network Configuration: Interface configuration, VLAN management, and routing setup
• ✅ Real-time Monitoring: System status, port statistics, and network diagnostics
• ✅ Secure Operations: Authenticated command execution with proper error handling
• ✅ MCP Compliance: Full Model Context Protocol implementation with tools, resources, and prompts

Supported Zyxel Models

Based on the integrated CLI documentation:

• GS1920 Series (24/48 port variants)
• GS1900 Series
• XGS1930 Series
• XGS2220 Series
• Other managed Zyxel switches with CLI access

MCP Tools (CLI Commands)

Connection Management

• zyxel_connect - Connect to a Zyxel switch
• zyxel_disconnect - Disconnect from the switch
• zyxel_connection_status - Check connection status

System Information

• zyxel_show_version - Display system version information
• zyxel_show_system_info - Show detailed system information
• zyxel_show_running_config - Display running configuration
• zyxel_show_startup_config - Display startup configuration

Interface Management

• zyxel_show_interfaces - Display interface status and configuration
• zyxel_configure_interface - Configure interface settings
• zyxel_configure_switchport - Configure switchport settings

VLAN Management

• zyxel_show_vlan - Display VLAN information
• zyxel_create_vlan - Create a new VLAN
• zyxel_delete_vlan - Delete a VLAN

Network Monitoring

• zyxel_show_mac_table - Display MAC address table
• zyxel_show_arp_table - Display ARP table
• zyxel_show_spanning_tree - Display spanning tree information
• zyxel_ping - Test network connectivity

Configuration Management

• zyxel_save_config - Save running configuration to startup
• zyxel_execute_cli - Execute raw CLI commands

MCP Resources (Read-only Data)

System Resources

• zyxel://switch/version - System version information
• zyxel://switch/system-info - Detailed system information
• zyxel://switch/running-config - Current running configuration
• zyxel://switch/startup-config - Saved startup configuration

Network Resources

• zyxel://switch/interfaces - Interface status and statistics
• zyxel://switch/vlans - VLAN configuration and status
• zyxel://switch/mac-table - MAC address table entries
• zyxel://switch/arp-table - ARP table entries
• zyxel://switch/spanning-tree - Spanning tree topology
• zyxel://switch/port-statistics - Port traffic statistics

Documentation

• zyxel://docs/cli-reference - Complete CLI command reference
• zyxel://docs/troubleshooting - Troubleshooting guide

MCP Prompts (Guided Workflows)

Setup and Configuration

• zyxel_initial_setup - Guide for initial switch setup
• zyxel_vlan_setup - Step-by-step VLAN configuration
• zyxel_port_configuration - Port configuration guide

Maintenance and Operations

• zyxel_troubleshooting - Network troubleshooting procedures
• zyxel_backup_restore - Configuration backup and restore
• zyxel_monitoring_setup - Monitoring and logging setup

Security and Performance

• zyxel_security_hardening - Security configuration best practices
• zyxel_performance_optimization - Performance tuning guide

Installation

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the project:

npm run build

Usage

Direct Execution

npm start

As MCP Server

Configure your MCP client to use this server:

{
  "mcpServers": {
    "zyxel": {
      "command": "npx",
      "args": ["zyxel-mcp-server"]
    }
  }
}

Development Mode

npm run dev

Configuration

The server can be configured through environment variables:

• ZYXEL_DEFAULT_HOST - Default switch IP address
• ZYXEL_DEFAULT_USERNAME - Default username
• ZYXEL_DEFAULT_PASSWORD - Default password
• ZYXEL_TIMEOUT - Command timeout in milliseconds (default: 30000)
• ZYXEL_DEBUG - Enable debug logging (true/false)

Examples

Connecting to a Switch

// Use the zyxel_connect tool
{
  "host": "192.168.1.100",
  "username": "admin",
  "password": "admin123",
  "port": 22
}

Creating a VLAN

// Use the zyxel_create_vlan tool
{
  "vlanId": 100,
  "name": "Production_VLAN",
  "description": "Production network VLAN"
}

Configuring an Interface

// Use the zyxel_configure_interface tool
{
  "interface": "ethernet 1/5",
  "description": "User Workstation",
  "shutdown": false,
  "speed": "auto",
  "duplex": "auto"
}

Project Structure

src/
├── cli/
│   ├── handler.ts     # CLI command execution
│   └── types.ts       # Type definitions
├── tools/
│   └── manager.ts     # MCP tools implementation
├── resources/
│   └── manager.ts     # MCP resources implementation
├── prompts/
│   └── manager.ts     # MCP prompts implementation
└── index.ts           # Main server entry point

Development

Building

npm run build

Type Checking

npm run typecheck

Cleaning

npm run clean

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Supported Zyxel Models

This MCP server has been designed to work with various Zyxel switch models, including:

• GS1920 Series
• GS1900 Series
• XGS1930 Series
• XGS2220 Series
• And other Zyxel managed switches with CLI access

Support

For issues and support:

1. Check the troubleshooting guide
2. Search existing GitHub issues
3. Create a new issue with detailed information

Acknowledgments

• Model Context Protocol specification
• MCP TypeScript SDK
• Zyxel for their comprehensive CLI documentation