用途：面向 Cisco Catalyst Center 的客户端运维与监控，覆盖有线与无线客户端的查询、统计与分析，适合容量规划、无线排障、安全定位和帮助台升级处理。
主要能力：get_clients_list 列出客户端（单次上限 100 条，超出时返回总数并提示收窄筛选）；get_client_details_by_mac 按 MAC 获取单个客户端详情，含 IP、主机名、OS、接入设备与接口、VLAN、SSID、频段、信道、RSSI、SNR、速率、连接时间与健康分等；get_clients_count 按筛选条件返回客户端总数，用于分析而不拉取完整记录。筛选维度包括 client_type、os_type、site_hierarchy、ipv4_address、mac_address、ssid、band、wlc_name 等，列表类参数需传 JSON 字符串数组。
使用方式：所有工具调用统一使用环境变量与 MCP 调用模式，例如 CCC_HOST=$CCC_HOST CCC_USER=$CCC_USER CCC_PWD=$CCC_PWD python3 $MCP_CALL "python3 -u $CATC_MCP_SCRIPT" TOOL_NAME 'ARGS_JSON'。客户端 API 要求 startTime 与 endTime 为 epoch 毫秒，且 startTime 最多回溯 30 天，因此应先调用 get_api_compatible_time_range 把“last 2 hours”“today”等人类可读时间或 ISO 时间转换为合法毫秒对；若返回 adjusted_for_30_day_limit 为 true，说明起始时间被自动截断，需告知用户实际时间范围更短。
适用场景：按 SSID 或站点统计客户端、按 MAC 或 IP 定位设备、站点客户端分布报告、按小时统计客户端趋势、OS 分布与无线频段分布分析等。
限制：get_clients_list 单次最多 100 条，超过需增加筛选条件；时间范围受 30 天回溯限制；按 MAC 查询在 API 返回 14006（数据未就绪）时会自动用建议的 endTime 重试。文档未提供收费、价格或平台支持信息。