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 管理存取權限。

文件

The Fabric MCP server 位於 https://mcp.equinix.com/fabric。有關設定、驗證和安全性指引,請參閱 MCP Server Overview。

[!-secondary] -secondary 公開預覽

Fabric MCP server 目前為公開預覽狀態。工具、描述和回應格式可能在正式發行前有所變更。

如需意見回饋、問題或 MCP server 的協助,請寄送電子郵件至 fabric-intelligence-support@equinix.com。

權限等級

以下表格中的每個工具皆列出呼叫該工具所需的最低權限等級。兩項控制必須允許呼叫:指派給您的 Equinix Customer Portal 帳戶的角色,以及您在連線用戶端時選擇的權限等級。簽發的權杖授予兩者的交集。如需更多資訊,請參閱 Permissions Model。

等級說明 Viewer 搜尋和查詢。不進行任何變更。 Operator 具備 Viewer 存取權,加上修改現有資源及附加或分離操作。 Manager 具備 Operator 存取權,加上建立資源。訂購連接埠或 Cloud Router 的計費費率與在入口網站中訂購相同。
Viewer搜尋和查詢。不進行任何變更。
Operator具備 Viewer 存取權,加上修改現有資源及附加或分離操作。
Manager具備 Operator 存取權,加上建立資源。訂購連接埠或 Cloud Router 的計費費率與在入口網站中訂購相同。

使用涵蓋工作範圍的最小權限等級。以 Viewer 連線的用戶端無法變更資源,無論帳戶被指派哪些角色。

伺服器不發布任何刪除工具。任何權限等級(包括 Manager)都無法移除連線、連接埠、Cloud Router 或網路。

工具

連線

工具等級說明API 參考 search_connections Viewer 使用進階篩選、分頁和排序搜尋 Fabric Connections Search Connection check_connection Viewer 在建立前驗證 Fabric Connection 設定 Validate Connection create_connection Operator 建立新的 Fabric Connection Create Connection update_connection Operator 使用其 UUID 更新 Equinix Fabric Connection Update Connection retry_connection Operator 對 Fabric Connection 執行操作 Connection Actions
search_connectionsViewer使用進階篩選、分頁和排序搜尋 Fabric ConnectionsSearch Connection
check_connectionViewer在建立前驗證 Fabric Connection 設定Validate Connection
create_connectionOperator建立新的 Fabric ConnectionCreate Connection
update_connectionOperator使用其 UUID 更新 Equinix Fabric ConnectionUpdate Connection
retry_connectionOperator對 Fabric Connection 執行操作Connection Actions

Metros

工具等級說明API 參考 list_metros Viewer 擷取 Fabric 中所有可用的 metros Get All Metros get_metro Viewer 透過傳遞 Metro Code 擷取特定 Fabric Metro 的詳細資訊 Get Metro by Code
list_metrosViewer擷取 Fabric 中所有可用的 metrosGet All Metros
get_metroViewer透過傳遞 Metro Code 擷取特定 Fabric Metro 的詳細資訊Get Metro by Code

專案

工具等級說明API 參考 list_project Viewer 列出您的帳戶可看見的專案及其專案識別碼 Get Projects list_projects 擷取 Equinix Substrate Governance API 中所有可用的專案。 API Reference
list_projectViewer列出您的帳戶可看見的專案及其專案識別碼Get Projects
list_projects擷取 Equinix Substrate Governance API 中所有可用的專案。API Reference

定價

工具等級說明API 參考 search_prices Viewer 搜尋 Fabric 資源的定價資訊 Search Prices
search_pricesViewer搜尋 Fabric 資源的定價資訊Search Prices

連接埠

工具等級說明API 參考 search_ports Viewer 使用進階篩選、分頁和排序搜尋 Fabric Ports Search Ports get_vlan_port Viewer 取得特定連接埠的 VLAN 設定 Get Port VLANs create_port Manager 建立新的 Equinix Fabric Port Create Port update_port Operator 更新 Fabric Port 設定 Update Port attach_physical_ports_to_lag Operator 將實體連接埠附加至 Link Aggregation Group (LAG) Add to Lag
search_portsViewer使用進階篩選、分頁和排序搜尋 Fabric PortsSearch Ports
get_vlan_portViewer取得特定連接埠的 VLAN 設定Get Port VLANs
create_portManager建立新的 Equinix Fabric PortCreate Port
update_portOperator更新 Fabric Port 設定Update Port
attach_physical_ports_to_lagOperator將實體連接埠附加至 Link Aggregation Group (LAG)Add to Lag

Cloud Routers

工具等級說明API 參考 search_routers Viewer 使用進階篩選、分頁和排序搜尋 Equinix Fabric Cloud Routers Search Cloud Routers list_router_packages Viewer 列出所有可用的 Cloud Router 套件 List Packages create_router Manager 建立新的 Fabric Cloud Router Create Cloud Router update_router Manager 更新現有的 Fabric Cloud Router Update Cloud Router create_router_command Operator 執行路由器命令,例如 ping 或 traceroute Create Router Command search_router_commands Viewer 搜尋路由器命令執行結果 Search Router Commands search_routes Viewer 搜尋路由,包括公告、接收和有效路由 Search Routes refresh_routes Viewer 為 Cloud Router 建立路由表操作 Create Route Actions
search_routersViewer使用進階篩選、分頁和排序搜尋 Equinix Fabric Cloud RoutersSearch Cloud Routers
list_router_packagesViewer列出所有可用的 Cloud Router 套件List Packages
create_routerManager建立新的 Fabric Cloud RouterCreate Cloud Router
update_routerManager更新現有的 Fabric Cloud RouterUpdate Cloud Router
create_router_commandOperator執行路由器命令,例如 ping 或 tracerouteCreate Router Command
search_router_commandsViewer搜尋路由器命令執行結果Search Router Commands
search_routesViewer搜尋路由,包括公告、接收和有效路由Search Routes
refresh_routesViewer為 Cloud Router 建立路由表操作Create Route Actions

路由協定

工具等級說明API 參考 list_routing_protocols Viewer 列出連線的所有 Routing Protocols Get Routing Protocols create_routing_protocol Operator 建立新的 Routing Protocol Create Routing Protocols update_routing_protocol Operator 更新現有的 Routing Protocol Update Routing Protocols replace_routing_protocol Operator 取代現有的 Routing Protocol Replace Routing Protocols create_routing_protocol_action Operator 清除或重設 Routing Protocol 的 BGP 工作階段 Clear/Reset BGP list_routing_protocol_actions Viewer 取得 Routing Protocol 的所有 BGP 操作狀態 Get BGP Actions
list_routing_protocolsViewer列出連線的所有 Routing ProtocolsGet Routing Protocols
create_routing_protocolOperator建立新的 Routing ProtocolCreate Routing Protocols
update_routing_protocolOperator更新現有的 Routing ProtocolUpdate Routing Protocols
replace_routing_protocolOperator取代現有的 Routing ProtocolReplace Routing Protocols
create_routing_protocol_actionOperator清除或重設 Routing Protocol 的 BGP 工作階段Clear/Reset BGP
list_routing_protocol_actionsViewer取得 Routing Protocol 的所有 BGP 操作狀態Get BGP Actions

網路

工具等級說明API 參考 search_networks Viewer 搜尋 Fabric Networks Search Networks create_network Manager 建立新的 Fabric Network Create Network update_network Operator 更新現有的 Fabric Network Update Network
search_networksViewer搜尋 Fabric NetworksSearch Networks
create_networkManager建立新的 Fabric NetworkCreate Network
update_networkOperator更新現有的 Fabric NetworkUpdate Network

IP 區塊

工具等級說明API 參考 search_ip_blocks Viewer 搜尋 Fabric IP blocks Search IP Blocks add_ip_block_to_eia_service Operator 將 IP 區塊新增至 Equinix Internet Access 服務 Add IP Block
search_ip_blocksViewer搜尋 Fabric IP blocksSearch IP Blocks
add_ip_block_to_eia_serviceOperator將 IP 區塊新增至 Equinix Internet Access 服務Add IP Block

Service Profiles

工具等級說明API 參考 search_service_profiles Viewer 使用進階篩選搜尋 Fabric Service Profiles Search Service Profiles get_service_profile Viewer 透過 UUID 擷取特定 Service Profile 的詳細資訊 Get Profile list_service_profile_metros Viewer 取得特定 Service Profile 的 metro 資訊 Get Service Profile Metros create_service_profile Manager 建立新的 Fabric Service Profile Create Service Profile update_service_profile Operator 更新現有的 Service Profile Update Service Profile replace_service_profile Operator 取代 Service Profile 的設定 Replace Service Profile
search_service_profilesViewer使用進階篩選搜尋 Fabric Service ProfilesSearch Service Profiles
get_service_profileViewer透過 UUID 擷取特定 Service Profile 的詳細資訊Get Profile
list_service_profile_metrosViewer取得特定 Service Profile 的 metro 資訊Get Service Profile Metros
create_service_profileManager建立新的 Fabric Service ProfileCreate Service Profile
update_service_profileOperator更新現有的 Service ProfileUpdate Service Profile
replace_service_profileOperator取代 Service Profile 的設定Replace Service Profile

Service Tokens

工具等級說明API 參考 search_service_tokens Viewer 搜尋 Fabric Service Tokens Search Service Tokens create_service_token Operator 建立新的 Service Token Create Service Token update_service_token Operator 更新現有的 Service Token Update Service Token
search_service_tokensViewer搜尋 Fabric Service TokensSearch Service Tokens
create_service_tokenOperator建立新的 Service TokenCreate Service Token
update_service_tokenOperator更新現有的 Service TokenUpdate Service Token

Route Filters

工具等級說明API 參考 search_route_filters Viewer 搜尋 Cloud Router Route Filters Search Route Filters create_route_filter Operator 建立新的 Route Filter 以進行流量管理 Create Route Filter update_route_filter Operator 更新現有的 Route Filter 設定 Update Route Filter attach_route_filter Operator 將 Route Filter 附加到 Fabric Connection Attach Route Filter list_route_filters_for_connection Viewer 列出附加到 Fabric Connection 的所有 Route Filters Get All Route Filters list_route_filter_connections Viewer 擷取使用現有 Route Filter 的所有 Connections Get Route Filter Connections search_route_filter_attachments_for_fcr Viewer 搜尋指定 Cloud Router 的 Route Filter 附加項目 Search Cloud Router Route Filter Attachments get_route_filter_changes Viewer 擷取特定 Route Filter 的所有變更 Get All Changes list_route_filter_change Viewer 列出 route filter 的變更記錄 List Route Filter Changes get_route_filter_change 擷取 Equinix Route Filter Policy 的特定變更或更新日誌。 API Reference list_route_filter_changes 擷取 Equinix Route Filter Policy 的變更或更新歷史記錄。 API Reference
search_route_filtersViewer搜尋 Cloud Router Route FiltersSearch Route Filters
create_route_filterOperator建立新的 Route Filter 以進行流量管理Create Route Filter
update_route_filterOperator更新現有的 Route Filter 設定Update Route Filter
attach_route_filterOperator將 Route Filter 附加到 Fabric ConnectionAttach Route Filter
list_route_filters_for_connectionViewer列出附加到 Fabric Connection 的所有 Route FiltersGet All Route Filters
list_route_filter_connectionsViewer擷取使用現有 Route Filter 的所有 ConnectionsGet Route Filter Connections
search_route_filter_attachments_for_fcrViewer搜尋指定 Cloud Router 的 Route Filter 附加項目Search Cloud Router Route Filter Attachments
get_route_filter_changesViewer擷取特定 Route Filter 的所有變更Get All Changes
list_route_filter_changeViewer列出 route filter 的變更記錄List Route Filter Changes
get_route_filter_change擷取 Equinix Route Filter Policy 的特定變更或更新日誌。API Reference
list_route_filter_changes擷取 Equinix Route Filter Policy 的變更或更新歷史記錄。API Reference

Route Filter Rules

工具等級說明API 參考 list_route_filter_rules Viewer 列出特定 Route Filter 的所有規則 Get Route Filter Rules get_route_filter_rule Viewer 取得特定 Route Filter Rule 的詳細資訊 Get Route Filter Rule create_route_filter_rule Operator 為 Route Filter 建立新規則 Create Route Filter Rules update_route_filter_rule Operator 更新現有的 Route Filter Rule Update Route Filter Rule list_route_filter_rule_changes Viewer 列出 route filter rule 的變更記錄 List Rule Changes get_route_filter_rule_change Viewer 取得 route filter rule 的一筆變更記錄 Get Rule Change
list_route_filter_rulesViewer列出特定 Route Filter 的所有規則Get Route Filter Rules
get_route_filter_ruleViewer取得特定 Route Filter Rule 的詳細資訊Get Route Filter Rule
create_route_filter_ruleOperator為 Route Filter 建立新規則Create Route Filter Rules
update_route_filter_ruleOperator更新現有的 Route Filter RuleUpdate Route Filter Rule
list_route_filter_rule_changesViewer列出 route filter rule 的變更記錄List Rule Changes
get_route_filter_rule_changeViewer取得 route filter rule 的一筆變更記錄Get Rule Change

Route Aggregations

工具等級說明API 參考 search_route_aggregations Viewer 搜尋 Cloud Router Route Aggregations Search Route Aggregation get_route_aggregation Viewer 透過 UUID 擷取特定 Route Aggregation 的詳細資訊 Get Aggregation create_route_aggregation Operator 建立新的 Route Aggregation 以進行流量管理 Create Route Aggregation update_route_aggregation Operator 更新現有的 Route Aggregation 設定 Update Route Aggregation attach_route_aggregation Operator 將 Route Aggregation 附加到 Fabric Connection Attach Route Aggregation list_route_aggregations_for_connection Viewer 列出附加到 Fabric Connection 的所有 Route Aggregations Get All Aggregations list_route_aggregation_connections Viewer 擷取使用現有 Route Aggregation 的所有 Connections Get Route Aggregation Connections search_route_aggregation_attachments_for_fcr Viewer 搜尋指定 Cloud Router 的 Route Aggregation 附加項目 Search Cloud Router Route Aggregation Attachments list_route_aggregation_changes Viewer 列出 route aggregation 的變更記錄 List Route Aggregation Changes get_route_aggregation_change Viewer 取得 route aggregation 的一筆變更記錄 Get Route Aggregation Change
search_route_aggregationsViewer搜尋 Cloud Router Route AggregationsSearch Route Aggregation
get_route_aggregationViewer透過 UUID 擷取特定 Route Aggregation 的詳細資訊Get Aggregation
create_route_aggregationOperator建立新的 Route Aggregation 以進行流量管理Create Route Aggregation
update_route_aggregationOperator更新現有的 Route Aggregation 設定Update Route Aggregation
attach_route_aggregationOperator將 Route Aggregation 附加到 Fabric ConnectionAttach Route Aggregation
list_route_aggregations_for_connectionViewer列出附加到 Fabric Connection 的所有 Route AggregationsGet All Aggregations
list_route_aggregation_connectionsViewer擷取使用現有 Route Aggregation 的所有 ConnectionsGet Route Aggregation Connections
search_route_aggregation_attachments_for_fcrViewer搜尋指定 Cloud Router 的 Route Aggregation 附加項目Search Cloud Router Route Aggregation Attachments
list_route_aggregation_changesViewer列出 route aggregation 的變更記錄List Route Aggregation Changes
get_route_aggregation_changeViewer取得 route aggregation 的一筆變更記錄Get Route Aggregation Change

Route Aggregation Rules

工具等級說明API 參考 list_route_aggregation_rules Viewer 列出特定 Route Aggregation 的所有規則 List Route Aggregation Rules get_route_aggregation_rule Viewer 取得特定 Route Aggregation Rule 的詳細資訊 Get Route Aggregation Rule create_route_aggregation_rule Operator 為 Route Aggregation 建立新規則 Create Route Aggregation Rules update_route_aggregation_rule Operator 更新現有的 Route Aggregation Rule Update Route Aggregation Rule list_route_aggregation_rule_changes Viewer 列出 route aggregation rule 的變更記錄 List Rule Changes get_route_aggregation_rule_change Viewer 取得 route aggregation rule 的一筆變更記錄 Get Rule Change
list_route_aggregation_rulesViewer列出特定 Route Aggregation 的所有規則List Route Aggregation Rules
get_route_aggregation_ruleViewer取得特定 Route Aggregation Rule 的詳細資訊Get Route Aggregation Rule
create_route_aggregation_ruleOperator為 Route Aggregation 建立新規則Create Route Aggregation Rules
update_route_aggregation_ruleOperator更新現有的 Route Aggregation RuleUpdate Route Aggregation Rule
list_route_aggregation_rule_changesViewer列出 route aggregation rule 的變更記錄List Rule Changes
get_route_aggregation_rule_changeViewer取得 route aggregation rule 的一筆變更記錄Get Rule Change

Telemetry Streams

工具等級說明API 參考 list_streams Viewer 列出您帳戶中的所有遙測串流 Get Streams get_stream Viewer 取得單一遙測串流的詳細資料 Get Stream create_stream Manager 建立新的遙測串流 Create Stream update_stream Manager 更新現有的遙測串流 Update Stream get_stream_network_edge_device Viewer 取得附加至遙測串流的網路邊緣裝置詳細資料 Get Stream Network Edge Device update_stream_network_edge_device Operator 更新或附加網路邊緣裝置至遙測串流 Update Stream Network Edge Device
list_streamsViewer列出您帳戶中的所有遙測串流Get Streams
get_streamViewer取得單一遙測串流的詳細資料Get Stream
create_streamManager建立新的遙測串流Create Stream
update_streamManager更新現有的遙測串流Update Stream
get_stream_network_edge_deviceViewer取得附加至遙測串流的網路邊緣裝置詳細資料Get Stream Network Edge Device
update_stream_network_edge_deviceOperator更新或附加網路邊緣裝置至遙測串流Update Stream Network Edge Device

串流資產

工具等級說明API 參考 search_attached_assets Viewer 搜尋附加至遙測串流的資產 Search Asset to Stream list_stream_attached_assets_by_type Viewer 列出附加至遙測串流並依資產類型篩選的資產 Get Assets get_stream_attached_asset Viewer 取得附加至串流的單一資產詳細資料 Get Stream Asset attach_stream_asset Operator 附加資產至遙測串流 Attach Asset to Stream
search_attached_assetsViewer搜尋附加至遙測串流的資產Search Asset to Stream
list_stream_attached_assets_by_typeViewer列出附加至遙測串流並依資產類型篩選的資產Get Assets
get_stream_attached_assetViewer取得附加至串流的單一資產詳細資料Get Stream Asset
attach_stream_assetOperator附加資產至遙測串流Attach Asset to Stream

串流訂閱

工具等級說明API 參考 list_stream_subscriptions Viewer 列出特定遙測串流的所有訂閱 List Stream Subscription get_stream_subscription Viewer 取得單一串流訂閱的詳細資料 Get Stream Subscription create_stream_subscription Operator 建立新的遙測串流訂閱 Create Stream Subscription update_stream_subscription Operator 更新現有的遙測串流訂閱 Update Stream Subscription
list_stream_subscriptionsViewer列出特定遙測串流的所有訂閱List Stream Subscription
get_stream_subscriptionViewer取得單一串流訂閱的詳細資料Get Stream Subscription
create_stream_subscriptionOperator建立新的遙測串流訂閱Create Stream Subscription
update_stream_subscriptionOperator更新現有的遙測串流訂閱Update Stream Subscription

串流警示規則

工具等級說明API 參考 list_stream_alert_rules Viewer 列出串流的所有警示規則 Get Alert Rules get_stream_alert_rule Viewer 取得單一串流警示規則的詳細資料 Get Alert Rule create_stream_alert_rule Operator 為串流建立新的警示規則 Create Alert Rule replace_stream_alert_rule Operator 取代串流警示規則 Replace Alert Rule
list_stream_alert_rulesViewer列出串流的所有警示規則Get Alert Rules
get_stream_alert_ruleViewer取得單一串流警示規則的詳細資料Get Alert Rule
create_stream_alert_ruleOperator為串流建立新的警示規則Create Alert Rule
replace_stream_alert_ruleOperator取代串流警示規則Replace Alert Rule

Application Connect

工具等級說明API 參考 search_application_links Viewer 搜尋 Application Connect 連結 Search Links get_application_link Viewer 取得單一 Application Connect 連結的詳細資料 Get Link create_application_link Manager 建立 Application Connect 連結 Create Link attach_application_domain_to_link Operator 附加網域至 Application Connect 連結 Attach Domain attach_application_service_to_link Operator 附加服務至 Application Connect 連結 Attach Service search_application_domains Viewer 搜尋 Application Connect 網域 Search Domains get_application_domain Viewer 取得單一 Application Connect 網域的詳細資料 Get Domain create_application_domain Operator 建立 Application Connect 網域 Create Domain search_application_services Viewer 搜尋 Application Connect 服務 Search Services create_application_service Operator 建立 Application Connect 服務 Create Service search_application_subscriptions Viewer 搜尋 Application Connect 訂閱 Search Subscriptions create_application_subscription Operator 建立 Application Connect 訂閱 Create Subscription
search_application_linksViewer搜尋 Application Connect 連結Search Links
get_application_linkViewer取得單一 Application Connect 連結的詳細資料Get Link
create_application_linkManager建立 Application Connect 連結Create Link
attach_application_domain_to_linkOperator附加網域至 Application Connect 連結Attach Domain
attach_application_service_to_linkOperator附加服務至 Application Connect 連結Attach Service
search_application_domainsViewer搜尋 Application Connect 網域Search Domains
get_application_domainViewer取得單一 Application Connect 網域的詳細資料Get Domain
create_application_domainOperator建立 Application Connect 網域Create Domain
search_application_servicesViewer搜尋 Application Connect 服務Search Services
create_application_serviceOperator建立 Application Connect 服務Create Service
search_application_subscriptionsViewer搜尋 Application Connect 訂閱Search Subscriptions
create_application_subscriptionOperator建立 Application Connect 訂閱Create Subscription

可觀測性 - 串流

工具說明API 端點 search_streams 使用篩選器、萬用字元比對、排序和分頁搜尋 Equinix Fabric 串流。 API Reference
search_streams使用篩選器、萬用字元比對、排序和分頁搜尋 Equinix Fabric 串流。API Reference

範例提示

以下範例顯示這些工具支援的請求類型。用戶端會選擇要呼叫的工具。您不需要指名它們。

日常使用

  • "顯示我在 SV 都會區的所有作用中連線。"
  • "哪些連接埠使用率過高或可用頻寬為負值?"
  • "摘要我的 Fabric Cloud Routers。"
  • "我可以在哪些專案中建立 Cloud Router?"
  • "將名為 <connection_name> 的連線頻寬變更為 1 Gbps。"
  • "Ping 這個路由器型連線的遠端。"
  • "法蘭克福的 10 Gbps 連接埠要多少錢?"

較大的問題

這些工具可以組合使用,讓代理程式完成多步驟分析:

  • "查看每個都會區的連接埠、路由器和連線使用率。找出使用率偏低的項目,並告訴我們可以在哪裡削減支出而不影響效能。"
  • "找出我們以單一路徑終止且應該有第二條路徑的都會區。"
  • "檢視我們的連線拓撲,並列出單點故障。"

對於這些請求,代理程式會讀取即時庫存並從中推導結論。在採取行動前請先檢閱結果,並確認任何會修改資源的請求。