SuperAPI AI 工具集

clab-lab-management

部署与运维

查看项目

更新于 10-15 17:21

技能介绍

用途:通过 MCP 服务管理 ContainerLab 容器化网络实验环境的完整生命周期,包括认证、列出、部署、查看、执行命令和销毁。

主要能力:提供 authenticate(手动认证覆盖,通常由自动认证处理)、listLabs(列出服务器上所有实验环境)、deployLab(用拓扑 JSON 部署新实验环境,支持 reconfigure)、inspectLab(获取实验环境详情、节点状态和管理 IP)、execCommand(在一个或全部节点上执行命令)、destroyLab(销毁实验环境并清理资源,支持 cleanup 与 graceful)。每次工具调用会自动认证,无需显式调用 authenticate。

使用方式:MCP 服务命令为 python3 -u $CLAB_MCP_SCRIPT(stdio 传输),需设置环境变量 CLAB_API_SERVER_URL、CLAB_API_USERNAME、CLAB_API_PASSWORD;CLAB_MCP_SCRIPT 与 MCP_CALL 由 install.sh 设置。调用格式为 python3 $MCP_CALL "python3 -u $CLAB_MCP_SCRIPT" <tool_name> '<args_json>'。典型流程:先 listLabs 避免名称冲突,再 deployLab 部署拓扑,随后 inspectLab(details: true)验证并获取管理 IP,最后用 execCommand 执行 show 命令验证连通性。清理时先与用户确认,再用 destroyLab(graceful: true、cleanup: true)销毁。

拓扑支持:节点以 kind 与 image 定义,支持 cisco_iosxr、cisco_iosxe、cisco_nxos、cisco_ftdv、nokia_srlinux、ceos、juniper_crpd、frr、linux 等类型,完整列表见 ContainerLab 文档。

适用场景:多厂商网络实验、spine-leaf 拓扑搭建、网络配置验证等实验性操作。

限制与注意:仅限实验环境操作,无需 ServiceNow CR 审批;要求记录 GAIT 审计轨迹;部署前先列出、部署后先查看;销毁建议 graceful。认证失败(401)时检查 ~/.openclaw/.env 中的环境变量,若 API 服务器运行在 Docker 中,创建 Linux 用户后可能需重启容器;部署失败检查拓扑语法与名称冲突;执行失败先用 inspectLab 确认实验环境已部署及节点名正确;销毁失败先用 listLabs 确认名称,graceful 超时可去掉该参数重试。其他集成与细节暂未提供。