Zyxel MCP Server

Zyxel交换机MCP服务器

用于Zyxel交换机CLI命令的综合模型上下文协议（MCP）服务器，使AI应用程序能够与Zyxel开关交互，进行网络配置、监控和管理操作。

✅ 生产就绪：集成了Real Zyxel CLI命令

此MCP服务器现在包含 真实的Zyxel CLI命令和响应格式 摘自Zyxel官方文档（407页CLI参考指南）。所有模拟实现都已被真正的命令语法所取代。

特性

• ✅ Real CLI命令支持：来自官方文档的真实Zyxel开关CLI命令
• ✅ 生产就绪响应：GS1920/GS1900/XGS系列的实际命令输出格式
• ✅ 网络配置：接口配置、VLAN管理和路由设置
• ✅ 实时监控：系统状态、端口统计和网络诊断
• ✅ 安全操作：经过身份验证的命令执行，并进行了适当的错误处理
• ✅ MCP合规性：使用工具、资源和提示实现完整的模型上下文协议

支持的Zyxel模型

基于集成CLI文档：

• GS1920系列 （24/48端口变体）
• GS1900系列
• XGS1930系列
• XGS2220系列
• 其他具有CLI访问权限的受管Zyxel交换机

MCP工具（CLI命令）

连接管理

• zyxel_connect -连接到Zyxel开关
• zyxel_disconnect -从开关上断开
• zyxel_connection_status -检查连接状态

系统信息

• zyxel_show_version -显示系统版本信息
• zyxel_show_system_info -显示详细的系统信息
• zyxel_show_running_config -显示运行配置
• zyxel_show_startup_config -显示启动配置

接口管理

• zyxel_show_interfaces -显示界面状态和配置
• zyxel_configure_interface -配置界面设置
• zyxel_configure_switchport -配置交换机端口设置

VLAN管理

• zyxel_show_vlan -显示VLAN信息
• zyxel_create_vlan -创建新的VLAN
• zyxel_delete_vlan -删除VLAN

网络监控

• zyxel_show_mac_table -显示MAC地址表
• zyxel_show_arp_table -显示ARP表
• zyxel_show_spanning_tree -显示生成树信息
• zyxel_ping -测试网络连接

配置管理

• zyxel_save_config -将运行配置保存到启动
• zyxel_execute_cli -执行原始CLI命令

MCP资源（只读数据）

系统资源

• zyxel://switch/version -系统版本信息
• zyxel://switch/system-info -详细的系统信息
• zyxel://switch/running-config -当前运行配置
• zyxel://switch/startup-config -已保存启动配置

网络资源

• zyxel://switch/interfaces -接口状态和统计
• zyxel://switch/vlans -VLAN配置和状态
• zyxel://switch/mac-table -MAC地址表条目
• zyxel://switch/arp-table -ARP表条目
• zyxel://switch/spanning-tree -生成树拓扑
• zyxel://switch/port-statistics -港口交通统计

文档

• zyxel://docs/cli-reference -完整的CLI命令参考
• zyxel://docs/troubleshooting -故障排除指南

MCP提示（引导式工作流）

设置和配置

• zyxel_initial_setup -初始开关设置指南
• zyxel_vlan_setup -逐步VLAN配置
• zyxel_port_configuration -端口配置指南

维护与操作

• zyxel_troubleshooting -网络故障排除程序
• zyxel_backup_restore -配置备份和恢复
• zyxel_monitoring_setup -监控和记录设置

安全和性能

• zyxel_security_hardening -安全配置最佳实践
• zyxel_performance_optimization -性能调优指南

安装

1. 克隆存储库：

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

1. 安装依赖项：

npm install

1. 构建项目：

npm run build

用法

直接执行

npm start

作为MCP服务器

配置您的MCP客户端以使用此服务器：

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

发展模式

npm run dev

配置

服务器可以通过环境变量进行配置：

• ZYXEL_DEFAULT_HOST -默认交换机IP地址
• ZYXEL_DEFAULT_USERNAME -默认用户名
• ZYXEL_DEFAULT_PASSWORD -默认密码
• ZYXEL_TIMEOUT -命令超时（毫秒）（默认值：30000）
• ZYXEL_DEBUG -启用调试日志记录（true/false）

例子

连接到交换机

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

创建VLAN

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

配置接口

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

项目结构

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

发展

建筑

npm run build

类型检查

npm run typecheck

清洁

npm run clean

贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

支持的Zyxel模型

此MCP服务器设计用于各种Zyxel交换机型号，包括：

• GS1920系列
• GS1900系列
• XGS1930系列
• XGS2220系列
• 以及其他具有CLI访问权限的Zyxel管理交换机

支持

关于问题和支持：

1. 检查 故障排除指南
2. 搜索现有
3. 创建包含详细信息的新问题

致谢

• 模型上下文协议 规格
• MCP TypeScript SDK
• Zyxel提供全面的CLI文档