SuperAPI AI 工具集

catc-inventory

通用与其它

查看项目

更新于 10-15 17:21

技能介绍

用途:该技能面向 Cisco Catalyst Center(原 DNA Center)的设备清单与站点管理,通过 MCP 工具调用 Catalyst Center API,完成设备资产审计、可达性核查、站点层级查看与接口信息查询。

主要能力:提供三个工具。fetch_devices 从 /dna/intent/api/v1/network-device 获取并过滤设备,必须至少提供一个过滤参数(如 hostname、managementIpAddress、serialNumber、platformId、family、type、role、reachabilityStatus、collectionStatus、softwareVersion、softwareType、series、locationName、associatedWlcIp、macAddress、id、roleSource),并支持 offset、limit、sortBy、sortOrder 分页排序;返回字段包括 id、hostname、管理 IP、MAC、序列号、平台、软件版本、角色、可达性、采集状态、位置等。fetch_sites 无参数,返回完整站点层级(id、name、parentId、siteNameHierarchy、type、address 等)。fetch_interfaces 按设备 UUID 查询接口,返回端口名、管理/运行状态、速率、双工、VLAN、描述等。

使用方式:先设置 CCC_HOST、CCC_USER、CCC_PWD 环境变量,再用 MCP_CALL 协议调用工具,例如 fetch_devices '{"family":["Switches and Hubs"]}' 或 fetch_interfaces '{"device_id":"<UUID>"}'。接口查询需先通过 fetch_devices 取得设备 UUID。资料给出的典型流程包括:排查不可达设备、按角色/平台筛选交换机与路由器、按 WLC IP 查询关联 AP、站点分组生成清单报告、软件版本合规审计、按序列号/IP/MAC 定位设备、排查采集失败,以及与 pyATS 交叉核对版本和接口状态。完成操作后可按 GAIT 记录审计轨迹。

适用场景:园区或数据中心资产盘点、变更前基线确认、端口利用率与容量规划、合规检查、故障定位。

限制:fetch_devices 禁止无过滤条件调用,以免返回过大结果集;文档提示接口数据可能存在轮询延迟,与设备实际状态可能不一致;站点与接口返回字段以资料所列为准,其余能力暂未提供。