用途:跨 MSP 多租户环境发现并记录 Auvik 所管理的资产信息,包括设备、网络、接口、硬件组件、实体备注、审计历史和计费用量;可限定单个客户,也可扫描全部可见租户。
主要能力:通过 auvik-mcp 提供 auvik_verify_credentials(连接健康检查)、auvik_list_tenants(列出可见租户)、auvik_list_devices(按 info/detail/extended 级别列出或检查设备,支持名称/IP/ID 解析)、auvik_list_networks(按类型、扫描状态或关联设备过滤)、auvik_list_interfaces(按父设备、接口类型或运行状态过滤)、auvik_list_components(CPU、内存、磁盘、风扇、PSU)、auvik_list_entity_notes(实体备注)、auvik_list_entity_audits(审计日志,按用户、类别、状态、日期过滤)以及 auvik_get_usage(按日期范围的计费/用量,scope 可为 client 或 device)。
使用方式:运行 python3 mcp-servers/auvik-mcp/auvik_mcp_server.py(stdio 传输),使用 AUVIK_USERNAME 与 AUVIK_API_KEY 进行 Basic 认证。可选环境变量包括 AUVIK_BASE_URL(默认 https://auvikapi.us1.my.auvik.com)、AUVIK_VERIFY_SSL、AUVIK_TIMEOUT(默认 30 秒)、AUVIK_MAX_PAGES(默认 50)。设备名、主机名、IP 或部分名称会被解析为内部 ID;名称匹配多个记录时返回 ResolutionCandidate[]。列表工具自动聚合至 AUVIK_MAX_PAGES 上限,达到上限时返回 truncated: true 与 next_cursor。
适用场景:新 MSP 客户上线盘点、设备变更审计、计费用量复核;可与其他技能协作,例如 gait-session-tracking(会话需记录到 GAIT)、auvik-network-alerts、auvik-lifecycle、auvik-performance、netbox-reconcile、servicenow-change-workflow。
限制:完全只读,仅 GET 操作,无创建、更新或删除。detail_level=extended 必须同时提供 device_type,否则 Auvik API 返回 ValidationError。在 MSP 环境中应始终指定租户,否则返回跨租户结果。建议以名称或 IP 而非内部 ID 引用资产。