用途:cml-topology-builder 是一个 MCP Server,命令为 cml-mcp(pip 安装,stdio 传输),用于在 Cisco CML 中构建网络拓扑,包括添加节点、创建接口、连接链路、设置链路条件和添加注释。需配置 CML_URL、CML_USERNAME、CML_PASSWORD 环境变量。
主要能力:节点管理(get_node_defs、create_node、get_nodes、get_node);接口管理(create_interface、get_interfaces、get_interface);链路管理(create_link、get_links、get_link、set_link_condition、set_link_state);注释管理(create_annotation、get_annotations、delete_annotation)。set_link_condition 可设置带宽、延迟、抖动、丢包以模拟 WAN;set_link_state 可上下线链路以模拟故障。常见节点定义包括 iosv、iosvl2、iosxrv9000、nxosv9000、csr1000v、cat8000v、asav、server、external_connector、unmanaged_switch、wan_emulator,完整列表需用 get_node_defs 获取。
使用方式:先创建或获取实验(get_lab),用 get_node_defs 确认可用节点类型,规划坐标布局(建议同层水平间隔 200px,按核心/汇聚/接入/服务器分层),用 create_node 创建设备、create_interface 建接口,再用 create_link 连线;如需 WAN 特性可 set_link_condition,最后用 create_annotation 添加说明。注释工作流可添加标题、IP 地址规划、AS 号、OSPF 区域、VRF/VLAN 等标注。模拟链路故障时,先用 get_links 找链路,set_link_state 置 down,观察收敛后再置 up 恢复并验证。
限制与注意:必须先 get_node_defs 再建节点;创建接口后才能连链路;实验需处于 STOPPED 状态才能添加节点,无法修改运行中实验的拓扑;建议使用描述性标签并提前规划布局。工具出错时应直接报告错误信息,不应编造结果;写入类操作失败后不要自动重试,需明确确认后再重试。资料未提供更多安装细节与授权信息。