SuperAPI AI 工具集

arista-cvp

编程与开发

查看项目

更新于 10-15 17:21

技能介绍

用途:该技能是一个 MCP Server,通过 HTTPS REST 调用 CloudVision Resource API,用于自动化 Arista CloudVision Portal 的日常运维查询与标签管理。仓库为 noredistribution/mcp-cvp-fun,传输方式 stdio (FastMCP),需 Python 3.12+,依赖 fastmcp、httpx、python-dotenv,安装方式为 git clone 后 uv run(运行时解析依赖),入口命令:uv run --with fastmcp fastmcp run /path/to/mcp_server_rest.py。状态为社区演示,非官方支持。

主要能力(4 个工具):get_inventory 获取全部设备清单(主机名、型号、序列号、版本、MAC、IP、流式状态);get_events 获取全部事件(告警、警告、信息及严重性、时间戳、关联设备);get_connectivity_monitor 获取探针统计(抖动、时延、丢包、HTTP 响应时间);create_tag(tag_name, tag_value) 通过工作区流程创建设备级标签,分五步:创建 Workspace、创建 Tag、构建 Workspace、等待约 10 秒构建完成、提交 Workspace。

使用方式:先登录 CloudVision Portal,在 Settings → Service Accounts 创建服务账号并生成令牌;在 .env 中配置 CVP(实例主机名,如 www.arista.io)与 CVPTOKEN(令牌),且必填。认证以 access_token cookie 随每个请求发送,而非 Bearer 头。API 返回 NDJSON 格式。调用时应先 get_inventory 验证可连通与设备流式状态,再进行后续查询。

适用场景:Arista 设备发现、事件监控、网络健康检查、设备打标签、连通性基线记录,可与 pyats-network、junos-network、netbox-reconcile、nautobot-sot、servicenow-change-workflow、gait-session-tracking 等技能协作。

限制:为社区项目,源码中 TLS 验证被禁用,生产使用前需评估安全影响;create_tag 建议置于 ServiceNow 变更请求(Implement 状态)之后,并遵循命名规范;写操作失败后不应自动重试,需先报告错误并获确认。CVP、CVPTOKEN 未设置或无效时工具会报认证/连接错误。