Fabric MCP Server

官方

Fabric MCP 服务器公开了以下 MCP 工具,允许 AI 助手与您的 Equinix Fabric 资源进行交互。每个工具对应一个特定的 Fabric API 端点。

你可以用 Fabric MCP 做什么?

  • 搜索和检查 Fabric 资源 — 让您的助手使用 search_connections、search_ports、list_metros 或 search_networks 查找连接、端口、城域网或网络。

  • 创建和管理连接 — 让您的助手使用 create_connection 配置新的 Fabric 连接,通过 check_connection 验证配置,或使用 update_connection 更新现有连接。

  • 管理 Cloud Router 和路由 — 使用 create_router 设置路由器,使用 search_routes 检查路由表,或使用 create_router_command 运行 ping 或 traceroute 等诊断操作。

  • 配置路由协议和 BGP — 让您的助手使用 list_routing_protocols 和 create_routing_protocol 列出、创建或更新路由协议,或通过 create_routing_protocol_action 清除 BGP 会话。

  • 处理端口和 VLAN — 使用 get_vlan_port 检索端口的 VLAN 详细信息,使用 search_ports 搜索可用端口,或使用 attach_physical_ports_to_lag 将物理端口附加到 LAG。

  • 管理服务配置文件和令牌 — 使用 search_service_profiles 搜索服务配置文件,通过 create_service_profile 创建新的配置文件,或使用 search_service_tokens 和 create_service_token 管理访问权限。

文档

Fabric MCP 服务器可在 https://mcp.equinix.com/fabric 获取。有关设置、身份验证和安全指南,请参阅 MCP 服务器概述。

[!-secondary] -secondary 公共预览版

Fabric MCP 服务器目前处于公共预览阶段。工具、描述和响应格式在正式发布前可能会发生变化。

如需反馈、提问或获取 MCP 服务器相关帮助,请发送邮件至 fabric-intelligence-support@equinix.com。

权限级别

下表中的每个工具都列出了调用它所需的最低权限级别。调用必须同时满足两个控制条件:分配给您的 Equinix 客户门户账户的角色,以及您在连接客户端时选择的权限级别。颁发的令牌授予这两者的交集权限。有关更多信息,请参阅 权限模型。

级别描述 查看者 搜索和查找。不进行任何更改。 操作员 拥有查看者权限,并可修改现有资源以及执行附加或分离操作。 管理员 拥有操作员权限,并可创建资源。订购端口或 Cloud Router 的计费费率与在门户中订购相同。
查看者搜索和查找。不进行任何更改。
操作员拥有查看者权限,并可修改现有资源以及执行附加或分离操作。
管理员拥有操作员权限,并可创建资源。订购端口或 Cloud Router 的计费费率与在门户中订购相同。

请使用能够覆盖工作需求的最窄权限级别。以查看者权限连接的客户端无法更改资源,无论账户分配了哪些角色。

服务器不发布任何删除工具。任何权限级别(包括管理员)都无法删除连接、端口、Cloud Router 或网络。

工具

连接

工具级别描述API 参考 search_connections 查看者 使用高级筛选、分页和排序搜索 Fabric 连接 搜索连接 check_connection 查看者 在创建前验证 Fabric 连接配置 验证连接 create_connection 操作员 创建新的 Fabric 连接 创建连接 update_connection 操作员 使用 UUID 更新 Equinix Fabric 连接 更新连接 retry_connection 操作员 对 Fabric 连接执行操作 连接操作
search_connections查看者使用高级筛选、分页和排序搜索 Fabric 连接搜索连接
check_connection查看者在创建前验证 Fabric 连接配置验证连接
create_connection操作员创建新的 Fabric 连接创建连接
update_connection操作员使用 UUID 更新 Equinix Fabric 连接更新连接
retry_connection操作员对 Fabric 连接执行操作连接操作

城市

工具级别描述API 参考 list_metros 查看者 获取 Fabric 中所有可用的城市 获取所有城市 get_metro 查看者 通过传递城市代码检索特定 Fabric 城市的详细信息 按代码获取城市
list_metros查看者获取 Fabric 中所有可用的城市获取所有城市
get_metro查看者通过传递城市代码检索特定 Fabric 城市的详细信息按代码获取城市

项目

工具级别描述API 参考 list_project 查看者 列出您的账户可以查看的项目及其项目标识符 获取项目 list_projects 获取 Equinix Substrate Governance API 中所有可用的项目。 API 参考
list_project查看者列出您的账户可以查看的项目及其项目标识符获取项目
list_projects获取 Equinix Substrate Governance API 中所有可用的项目。API 参考

定价

工具级别描述API 参考 search_prices 查看者 搜索 Fabric 资源的定价信息 搜索价格
search_prices查看者搜索 Fabric 资源的定价信息搜索价格

端口

工具级别描述API 参考 search_ports 查看者 使用高级筛选、分页和排序搜索 Fabric 端口 搜索端口 get_vlan_port 查看者 获取特定端口的 VLAN 配置 获取端口 VLAN create_port 管理员 创建新的 Equinix Fabric 端口 创建端口 update_port 操作员 更新 Fabric 端口配置 更新端口 attach_physical_ports_to_lag 操作员 将物理端口附加到链路聚合组 (LAG) 添加到 LAG
search_ports查看者使用高级筛选、分页和排序搜索 Fabric 端口搜索端口
get_vlan_port查看者获取特定端口的 VLAN 配置获取端口 VLAN
create_port管理员创建新的 Equinix Fabric 端口创建端口
update_port操作员更新 Fabric 端口配置更新端口
attach_physical_ports_to_lag操作员将物理端口附加到链路聚合组 (LAG)添加到 LAG

Cloud Routers

工具级别描述API 参考 search_routers 查看者 使用高级筛选、分页和排序搜索 Equinix Fabric Cloud Routers 搜索 Cloud Routers list_router_packages 查看者 列出所有可用的 Cloud Router 套餐 列出套餐 create_router 管理员 创建新的 Fabric Cloud Router 创建 Cloud Router update_router 管理员 更新现有的 Fabric Cloud Router 更新 Cloud Router create_router_command 操作员 运行路由器命令,如 ping 或 traceroute 创建路由器命令 search_router_commands 查看者 搜索路由器命令执行结果 搜索路由器命令 search_routes 查看者 搜索路由,包括通告路由、接收路由和活动路由 搜索路由 refresh_routes 查看者 为 Cloud Router 创建路由表操作 创建路由操作
search_routers查看者使用高级筛选、分页和排序搜索 Equinix Fabric Cloud Routers搜索 Cloud Routers
list_router_packages查看者列出所有可用的 Cloud Router 套餐列出套餐
create_router管理员创建新的 Fabric Cloud Router创建 Cloud Router
update_router管理员更新现有的 Fabric Cloud Router更新 Cloud Router
create_router_command操作员运行路由器命令,如 ping 或 traceroute创建路由器命令
search_router_commands查看者搜索路由器命令执行结果搜索路由器命令
search_routes查看者搜索路由,包括通告路由、接收路由和活动路由搜索路由
refresh_routes查看者为 Cloud Router 创建路由表操作创建路由操作

路由协议

工具级别描述API 参考 list_routing_protocols 查看者 列出连接的所有路由协议 获取路由协议 create_routing_protocol 操作员 创建新的路由协议 创建路由协议 update_routing_protocol 操作员 更新现有的路由协议 更新路由协议 replace_routing_protocol 操作员 替换现有的路由协议 替换路由协议 create_routing_protocol_action 操作员 清除或重置路由协议的 BGP 会话 清除/重置 BGP list_routing_protocol_actions 查看者 获取路由协议的所有 BGP 操作状态 获取 BGP 操作
list_routing_protocols查看者列出连接的所有路由协议获取路由协议
create_routing_protocol操作员创建新的路由协议创建路由协议
update_routing_protocol操作员更新现有的路由协议更新路由协议
replace_routing_protocol操作员替换现有的路由协议替换路由协议
create_routing_protocol_action操作员清除或重置路由协议的 BGP 会话清除/重置 BGP
list_routing_protocol_actions查看者获取路由协议的所有 BGP 操作状态获取 BGP 操作

网络

工具级别描述API 参考 search_networks 查看者 搜索 Fabric 网络 搜索网络 create_network 管理员 创建新的 Fabric 网络 创建网络 update_network 操作员 更新现有的 Fabric 网络 更新网络
search_networks查看者搜索 Fabric 网络搜索网络
create_network管理员创建新的 Fabric 网络创建网络
update_network操作员更新现有的 Fabric 网络更新网络

IP 地址块

工具级别描述API 参考 search_ip_blocks 查看者 搜索 Fabric IP 地址块 搜索 IP 地址块 add_ip_block_to_eia_service 操作员 将 IP 地址块添加到 Equinix Internet Access 服务 添加 IP 地址块
search_ip_blocks查看者搜索 Fabric IP 地址块搜索 IP 地址块
add_ip_block_to_eia_service操作员将 IP 地址块添加到 Equinix Internet Access 服务添加 IP 地址块

服务配置文件

工具级别描述API 参考 search_service_profiles 查看器 使用高级筛选搜索 Fabric 服务配置文件 搜索服务配置文件 get_service_profile 查看器 按 UUID 检索特定服务配置文件的详细信息 获取配置文件 list_service_profile_metros 查看器 获取特定服务配置文件的城域信息 获取服务配置文件城域 create_service_profile 管理器 创建新的 Fabric 服务配置文件 创建服务配置文件 update_service_profile 操作员 更新现有的服务配置文件 更新服务配置文件 replace_service_profile 操作员 替换服务配置文件配置 替换服务配置文件
search_service_profiles查看器使用高级筛选搜索 Fabric 服务配置文件搜索服务配置文件
get_service_profile查看器按 UUID 检索特定服务配置文件的详细信息获取配置文件
list_service_profile_metros查看器获取特定服务配置文件的城域信息获取服务配置文件城域
create_service_profile管理器创建新的 Fabric 服务配置文件创建服务配置文件
update_service_profile操作员更新现有的服务配置文件更新服务配置文件
replace_service_profile操作员替换服务配置文件配置替换服务配置文件

服务令牌

工具级别描述API 参考 search_service_tokens 查看器 搜索 Fabric 服务令牌 搜索服务令牌 create_service_token 操作员 创建新的服务令牌 创建服务令牌 update_service_token 操作员 更新现有的服务令牌 更新服务令牌
search_service_tokens查看器搜索 Fabric 服务令牌搜索服务令牌
create_service_token操作员创建新的服务令牌创建服务令牌
update_service_token操作员更新现有的服务令牌更新服务令牌

路由过滤器

工具级别描述API 参考 search_route_filters 查看器 搜索云路由器路由过滤器 搜索路由过滤器 create_route_filter 操作员 创建新的路由过滤器以进行流量管理 创建路由过滤器 update_route_filter 操作员 更新现有的路由过滤器配置 更新路由过滤器 attach_route_filter 操作员 将路由过滤器附加到 Fabric 连接 附加路由过滤器 list_route_filters_for_connection 查看器 列出附加到 Fabric 连接的所有路由过滤器 获取所有路由过滤器 list_route_filter_connections 查看器 检索使用现有路由过滤器的所有连接 获取路由过滤器连接 search_route_filter_attachments_for_fcr 查看器 搜索给定云路由器的路由过滤器附件 搜索云路由器路由过滤器附件 get_route_filter_changes 查看器 检索特定路由过滤器的所有更改 获取所有更改 list_route_filter_change 查看器 列出路由过滤器的更改记录 列出路由过滤器更改 get_route_filter_change 检索 Equinix 路由过滤器策略的特定更改或更新日志。 API 参考 list_route_filter_changes 检索 Equinix 路由过滤器策略的更改或更新历史。 API 参考
search_route_filters查看器搜索云路由器路由过滤器搜索路由过滤器
create_route_filter操作员创建新的路由过滤器以进行流量管理创建路由过滤器
update_route_filter操作员更新现有的路由过滤器配置更新路由过滤器
attach_route_filter操作员将路由过滤器附加到 Fabric 连接附加路由过滤器
list_route_filters_for_connection查看器列出附加到 Fabric 连接的所有路由过滤器获取所有路由过滤器
list_route_filter_connections查看器检索使用现有路由过滤器的所有连接获取路由过滤器连接
search_route_filter_attachments_for_fcr查看器搜索给定云路由器的路由过滤器附件搜索云路由器路由过滤器附件
get_route_filter_changes查看器检索特定路由过滤器的所有更改获取所有更改
list_route_filter_change查看器列出路由过滤器的更改记录列出路由过滤器更改
get_route_filter_change检索 Equinix 路由过滤器策略的特定更改或更新日志。API 参考
list_route_filter_changes检索 Equinix 路由过滤器策略的更改或更新历史。API 参考

路由过滤器规则

工具级别描述API 参考 list_route_filter_rules 查看器 列出特定路由过滤器的所有规则 获取路由过滤器规则 get_route_filter_rule 查看器 获取特定路由过滤器规则的详细信息 获取路由过滤器规则 create_route_filter_rule 操作员 为路由过滤器创建新规则 创建路由过滤器规则 update_route_filter_rule 操作员 更新现有的路由过滤器规则 更新路由过滤器规则 list_route_filter_rule_changes 查看器 列出路由过滤器规则的更改记录 列出规则更改 get_route_filter_rule_change 查看器 获取路由过滤器规则的一条更改记录 获取规则更改
list_route_filter_rules查看器列出特定路由过滤器的所有规则获取路由过滤器规则
get_route_filter_rule查看器获取特定路由过滤器规则的详细信息获取路由过滤器规则
create_route_filter_rule操作员为路由过滤器创建新规则创建路由过滤器规则
update_route_filter_rule操作员更新现有的路由过滤器规则更新路由过滤器规则
list_route_filter_rule_changes查看器列出路由过滤器规则的更改记录列出规则更改
get_route_filter_rule_change查看器获取路由过滤器规则的一条更改记录获取规则更改

路由聚合

工具级别描述API 参考 search_route_aggregations 查看器 搜索云路由器路由聚合 搜索路由聚合 get_route_aggregation 查看器 按 UUID 检索特定路由聚合的详细信息 获取聚合 create_route_aggregation 操作员 创建新的路由聚合以进行流量管理 创建路由聚合 update_route_aggregation 操作员 更新现有的路由聚合配置 更新路由聚合 attach_route_aggregation 操作员 将路由聚合附加到 Fabric 连接 附加路由聚合 list_route_aggregations_for_connection 查看器 列出附加到 Fabric 连接的所有路由聚合 获取所有聚合 list_route_aggregation_connections 查看器 检索使用现有路由聚合的所有连接 获取路由聚合连接 search_route_aggregation_attachments_for_fcr 查看器 搜索给定云路由器的路由聚合附件 搜索云路由器路由聚合附件 list_route_aggregation_changes 查看器 列出路由聚合的更改记录 列出路由聚合更改 get_route_aggregation_change 查看器 获取路由聚合的一条更改记录 获取路由聚合更改
search_route_aggregations查看器搜索云路由器路由聚合搜索路由聚合
get_route_aggregation查看器按 UUID 检索特定路由聚合的详细信息获取聚合
create_route_aggregation操作员创建新的路由聚合以进行流量管理创建路由聚合
update_route_aggregation操作员更新现有的路由聚合配置更新路由聚合
attach_route_aggregation操作员将路由聚合附加到 Fabric 连接附加路由聚合
list_route_aggregations_for_connection查看器列出附加到 Fabric 连接的所有路由聚合获取所有聚合
list_route_aggregation_connections查看器检索使用现有路由聚合的所有连接获取路由聚合连接
search_route_aggregation_attachments_for_fcr查看器搜索给定云路由器的路由聚合附件搜索云路由器路由聚合附件
list_route_aggregation_changes查看器列出路由聚合的更改记录列出路由聚合更改
get_route_aggregation_change查看器获取路由聚合的一条更改记录获取路由聚合更改

路由聚合规则

工具级别描述API 参考 list_route_aggregation_rules 查看器 列出特定路由聚合的所有规则 列出路由聚合规则 get_route_aggregation_rule 查看器 获取特定路由聚合规则的详细信息 获取路由聚合规则 create_route_aggregation_rule 操作员 为路由聚合创建新规则 创建路由聚合规则 update_route_aggregation_rule 操作员 更新现有的路由聚合规则 更新路由聚合规则 list_route_aggregation_rule_changes 查看器 列出路由聚合规则的更改记录 列出规则更改 get_route_aggregation_rule_change 查看器 获取路由聚合规则的一条更改记录 获取规则更改
list_route_aggregation_rules查看器列出特定路由聚合的所有规则列出路由聚合规则
get_route_aggregation_rule查看器获取特定路由聚合规则的详细信息获取路由聚合规则
create_route_aggregation_rule操作员为路由聚合创建新规则创建路由聚合规则
update_route_aggregation_rule操作员更新现有的路由聚合规则更新路由聚合规则
list_route_aggregation_rule_changes查看器列出路由聚合规则的更改记录列出规则更改
get_route_aggregation_rule_change查看器获取路由聚合规则的一条更改记录获取规则更改

遥测流

工具级别描述API 参考 list_streams 查看器 列出您账户中的所有遥测流 获取流 get_stream 查看器 获取单个遥测流的详细信息 获取流 create_stream 管理员 创建新的遥测流 创建流 update_stream 管理员 更新现有的遥测流 更新流 get_stream_network_edge_device 查看器 获取附加到遥测流的网络边缘设备的详细信息 获取流网络边缘设备 update_stream_network_edge_device 操作员 更新或附加遥测流的网络边缘设备 更新流网络边缘设备
list_streams查看器列出您账户中的所有遥测流获取流
get_stream查看器获取单个遥测流的详细信息获取流
create_stream管理员创建新的遥测流创建流
update_stream管理员更新现有的遥测流更新流
get_stream_network_edge_device查看器获取附加到遥测流的网络边缘设备的详细信息获取流网络边缘设备
update_stream_network_edge_device操作员更新或附加遥测流的网络边缘设备更新流网络边缘设备

流资产

工具级别描述API 参考 search_attached_assets 查看器 搜索附加到遥测流的资产 搜索流资产 list_stream_attached_assets_by_type 查看器 列出附加到遥测流的资产,按资产类型过滤 获取资产 get_stream_attached_asset 查看器 获取附加到流的单个资产的详细信息 获取流资产 attach_stream_asset 操作员 将资产附加到遥测流 附加资产到流
search_attached_assets查看器搜索附加到遥测流的资产搜索流资产
list_stream_attached_assets_by_type查看器列出附加到遥测流的资产,按资产类型过滤获取资产
get_stream_attached_asset查看器获取附加到流的单个资产的详细信息获取流资产
attach_stream_asset操作员将资产附加到遥测流附加资产到流

流订阅

工具级别描述API 参考 list_stream_subscriptions 查看器 列出特定遥测流的所有订阅 列出流订阅 get_stream_subscription 查看器 获取单个流订阅的详细信息 获取流订阅 create_stream_subscription 操作员 创建新的遥测流订阅 创建流订阅 update_stream_subscription 操作员 更新现有的遥测流订阅 更新流订阅
list_stream_subscriptions查看器列出特定遥测流的所有订阅列出流订阅
get_stream_subscription查看器获取单个流订阅的详细信息获取流订阅
create_stream_subscription操作员创建新的遥测流订阅创建流订阅
update_stream_subscription操作员更新现有的遥测流订阅更新流订阅

流警报规则

工具级别描述API 参考 list_stream_alert_rules 查看器 列出流的所有警报规则 获取警报规则 get_stream_alert_rule 查看器 获取单个流警报规则的详细信息 获取警报规则 create_stream_alert_rule 操作员 为流创建新的警报规则 创建警报规则 replace_stream_alert_rule 操作员 替换流警报规则 替换警报规则
list_stream_alert_rules查看器列出流的所有警报规则获取警报规则
get_stream_alert_rule查看器获取单个流警报规则的详细信息获取警报规则
create_stream_alert_rule操作员为流创建新的警报规则创建警报规则
replace_stream_alert_rule操作员替换流警报规则替换警报规则

应用连接

工具级别描述API 参考 search_application_links 查看器 搜索应用连接链接 搜索链接 get_application_link 查看器 获取单个应用连接链接的详细信息 获取链接 create_application_link 管理员 创建应用连接链接 创建链接 attach_application_domain_to_link 操作员 将域附加到应用连接链接 附加域 attach_application_service_to_link 操作员 将服务附加到应用连接链接 附加服务 search_application_domains 查看器 搜索应用连接域 搜索域 get_application_domain 查看器 获取单个应用连接域的详细信息 获取域 create_application_domain 操作员 创建应用连接域 创建域 search_application_services 查看器 搜索应用连接服务 搜索服务 create_application_service 操作员 创建应用连接服务 创建服务 search_application_subscriptions 查看器 搜索应用连接订阅 搜索订阅 create_application_subscription 操作员 创建应用连接订阅 创建订阅
search_application_links查看器搜索应用连接链接搜索链接
get_application_link查看器获取单个应用连接链接的详细信息获取链接
create_application_link管理员创建应用连接链接创建链接
attach_application_domain_to_link操作员将域附加到应用连接链接附加域
attach_application_service_to_link操作员将服务附加到应用连接链接附加服务
search_application_domains查看器搜索应用连接域搜索域
get_application_domain查看器获取单个应用连接域的详细信息获取域
create_application_domain操作员创建应用连接域创建域
search_application_services查看器搜索应用连接服务搜索服务
create_application_service操作员创建应用连接服务创建服务
search_application_subscriptions查看器搜索应用连接订阅搜索订阅
create_application_subscription操作员创建应用连接订阅创建订阅

可观测性 - 流

工具描述API 端点 search_streams 使用过滤器、通配符匹配、排序和分页搜索 Equinix Fabric 流。 API 参考
search_streams使用过滤器、通配符匹配、排序和分页搜索 Equinix Fabric 流。API 参考

示例提示

以下示例展示了这些工具支持的请求类型。客户端选择要调用的工具。您无需指定它们。

日常使用

  • "显示 SV 城域中所有活跃的连接。"
  • "哪些端口过度使用或可用带宽为负?"
  • "总结我的 Fabric Cloud Routers。"
  • "我可以在哪些项目中创建 Cloud Router?"
  • "将名为 <connection_name> 的连接带宽更改为 1 Gbps。"
  • "Ping 此基于路由器的连接的远端。"
  • "法兰克福的 10 Gbps 端口费用是多少?"

更复杂的问题

这些工具可以组合使用,使代理能够完成多步骤分析:

  • "查看每个城域的端口、路由器和连接使用情况。找出使用不足的资源,并告诉我可以在哪些地方削减开支而不影响性能。"
  • "找到我们仅依赖单一路径终止的城域,并确定应增加第二条路径的位置。"
  • "遍历我们的连接拓扑,列出单点故障。"

对于这些请求,代理读取实时库存并从中得出结论。在采取行动之前请审查结果,并确认任何修改资源的请求。