SuperAPI AI 工具集

meraki-switch-ops

部署与运维

查看项目

更新于 10-15 17:22

技能介绍

用途:通过 Cisco 官方 Meraki MCP 服务器(端点 https://mcp.meraki.com/mcp,远程 HTTP,无需本地安装;自托管备选 CiscoDevNet/cisco-meraki-mcp-official,Apache-2.0)以只读方式查询 Meraki 交换机配置与状态。需环境变量 MERAKI_DASHBOARD_API_KEY,建议使用只读 Dashboard 密钥。

主要能力:仅内置非弃用的 GET 操作,全部 431 个变更类操作(174 POST、186 PUT、71 DELETE)不在能力目录中,updateNetwork、rebootDevice、blinkDeviceLeds 等会返回 Capability not found。工具只有两个:semantic_search(用自然语言发现能力)和 execute_api(调用能力)。可直接调用的能力 ID 为 getOrganizations 与 getOrganizationNetworks,其余需先发现。常用能力包括 getDeviceSwitchPorts、getDeviceSwitchPortsStatuses、getDeviceSwitchPortsStatusesPackets、getNetworkSwitchAccessControlLists、getNetworkSwitchAccessPolicies、getNetworkSwitchRoutingMulticast、getDeviceSwitchRoutingInterfaces、getDeviceSwitchRoutingStaticRoutes、getDeviceSwitchWarmSpare 等,调用前用 semantic_search 确认。

使用方式:先 getOrganizations 取组织 ID,再 getOrganizationNetworks 取网络 ID,getOrganizationDevices 取设备序列号;端口类能力按设备序列号调用,而非网络 ID。典型流程为端口配置审计(逐端口核对 VLAN、类型、PoE、STP guard、隔离与链路状态)和端口错误排查(区分 errors 与 discards,再查包级明细)。

限制:execute_api 只返回单页,不能当作完整数据集;n=0 表示该网络未上报,不代表不存在。Capability not found、Resource not found、Invalid parameters 是三种不同错误,均不可报告为“无数据”。无任何写操作,端口、VLAN、ACL、QoS 变更须在 Meraki Dashboard 中直接完成。可与 meraki-network-ops、meraki-monitoring、meraki-security-appliance、gait-session-tracking 配合使用。