2026 年 5 月熱點:Agent Toolkit 與你要解的「哪一種卡住」
二〇二六年五月六日,AWS 宣布 Agent Toolkit for AWS 與託管 AWS MCP Server 正式上線(GA)。對正在 Cursor、Claude Desktop、Codex 或 Kiro 裡啟用 AI coding agent 的開發者而言,這套工具把超過一萬五千個 AWS API 操作、文件搜尋與沙箱腳本執行,收斂成 MCP 工具(例如 call_aws、search_documentation)。官方文件建議透過 uvx mcp-proxy-for-aws@latest 連到區域端點,例如 https://aws-mcp.us-east-1.api.aws/mcp 或歐洲 eu-central-1 對應網址。
搜尋框裡常見的抱怨卻很一致:「AWS MCP Server 初始化要幾分鐘」「npm/uv 拉套件卡住」「工具列表是空的」。這些並不一定是 IAM 設錯——更常是多條出站鏈路同時競爭:PyPI/npm CDN 在下載 mcp-proxy-for-aws;HTTPS 長連線在握手託管 MCP;背景還有 aws sts get-caller-identity 等 AWS API 請求。若你把三者綁在同一自動測速策略組,體感就會像整個 AWS Agent Toolkit 壞掉。本文服務的使用者搜尋意圖正是:在 Clash Verge Rev 裡做可落地的 MCP 分流,而不是再背一份會過期的網域表。
Agent Toolkit 四件套:哪一段流量該分開觀察?
依 AWS 文件,Agent Toolkit for AWS 包含四塊:託管 AWS MCP Server、四十餘個 Agent Skills 套件、預設 Plugins(如 AWS Core、Data Analytics、Agents)以及專案級 Rules。對 Clash 使用者來說,Skills/Plugins 多半再觸發文件站與套件 registry;真正敏感的是兩條硬鏈路:
- MCP 資料面:IDE 透過 stdio 啟動
uvx,由mcp-proxy-for-aws把 MCP 請求轉成帶 SigV4 的 AWS 請求,目標是aws-mcp.*.api.aws。 - AWS 控制面:代理代你呼叫的 EC2、S3、Lambda 等,會落到各區
*.amazonaws.com;--metadata AWS_REGION=...決定預設區域,與 MCP 端點 Region 可以不同。
文件工具(search_documentation/read_documentation)雖免驗證,仍會連到 docs.aws.amazon.com 等主機。安裝鏈路則常經 astral.sh 安裝 uv,再經 npm/PyPI 拉代理程式。任何一類被錯誤規則送去直連或高抖動節點,都會在 IDE 裡呈現成「MCP 工具載入失敗」。
aws-api-mcp-server 或 aws-knowledge-mcp-server,AWS 建議移除以免工具名稱衝突。分流規則應對準新託管端點與 mcp-proxy-for-aws,不要沿用已下線的自架 hostname。並行流量形狀:為什麼「只有 MCP 轉圈」很常見?
首次在 Cursor 寫入 mcp.json 並重啟後,典型時間軸是:① uvx 解析並下載 mcp-proxy-for-aws@latest(走 registry/tarball CDN);② 子進程對 aws-mcp.us-east-1.api.aws 建立 HTTPS(可能長時間保持);③ 你順手在終端跑 aws login 或 aws sts get-caller-identity(走 AWS API 另一條曲線)。瀏覽器開 AWS 主控台若仍順暢,只代表其中一條鏈路沒問題。
另一種形狀是子進程沒進核心:IDE 走系統代理,uvx 卻沿用舊的 HTTP_PROXY 或完全直連。此時你會在 Clash Verge Rev 連線表裡只看到零星 amazonaws.com,卻看不到 npm 或 api.aws——應先對齊決策鏈,再談 MCP 分流。
先在 Verge Rev:用連線紀錄還原 hostname
請將公開端點視為會演進的資料。實測步驟:在 Clash Verge Rev 開啟連線或稽核窗格;於 Cursor/Codex 觸發 MCP 重載;同時在終端執行一次會走 SigV4 的 AWS CLI 命令。建議分三個時間盒紀錄——純 uvx/npm、純 MCP 握手、純 API 呼叫——最後再讓三者重疊。若重疊時出站策略組在 url-test 間抖動,長連線 MCP 最容易被誤判逾時。
你應能在紀錄中辨識至少這幾類字串(具體子網域以當日紀錄為準):aws-mcp.us-east-1.api.aws、aws-mcp.eu-central-1.api.aws、registry.npmjs.org/PyPI 相關主機、sts.*.amazonaws.com 與你常用的工作負載區域端點。
--metadata AWS_REGION=... 則影響代呼叫資源的預設區域——Clash 規則應分開處理,不要假設同一策略組即可覆蓋。策略組設計:MCP、npm-CDN、AWS-API 三桶水
從紀錄歸納出 hostname 後,建議語意化命名,例如 AWS-MCP-ENDPOINT(託管 MCP HTTPS)、AWS-DEV-REGISTRY(uvx/npm/PyPI tarball)、AWS-CONTROL-API(STS 與工作負載 API)。MCP 桶偏好低抖動、可固定節點的 select;registry 桶可指向大頻寬節點;控制面 API 若需穩定 SigV4,避免與 tarball 下載共用會自動切換的 url-test。
下列 YAML 僅示範規則骨架,請以你紀錄中的實際主機名替換:
proxy-groups:
- name: AWS-MCP-ENDPOINT
type: select
proxies:
- NODE-STABLE-LOW-JITTER
- DIRECT
- name: AWS-DEV-REGISTRY
type: select
proxies:
- NODE-WIDE-NIC
- DIRECT
- name: AWS-CONTROL-API
type: select
proxies:
- NODE-STABLE-A
- DIRECT
rules:
- DOMAIN-SUFFIX,api.aws,AWS-MCP-ENDPOINT
- DOMAIN-SUFFIX,npmjs.org,AWS-DEV-REGISTRY
- DOMAIN-SUFFIX,amazonaws.com,AWS-CONTROL-API
- MATCH,GLOBAL
DOMAIN-SUFFIX,api.aws 會涵蓋區域 MCP 主機;若企業內網對 *.amazonaws.com 有細分需求,請在紀錄基礎上改寫為更精準的 DOMAIN 規則,並把已驗證條目放在 GEOIP 與大型 Rule Providers 之前。
Cursor、Codex 與 Claude:MCP 設定與代理要對齊
AWS 文件提供的 AWS MCP Server 範例在 Cursor、Claude Desktop、Codex 中結構相近:command 為 uvx,args 含 mcp-proxy-for-aws@latest 與區域 MCP URL。Codex 使用 [mcp_servers.aws_mcp] 並可設 startup_timeout_sec = 60——若 npm 拉取與 MCP 握手疊在同一出口排隊,六十秒很容易耗盡。
實務建議:先讓 Clash Verge Rev 啟用 TUN 或確認 uvx 繼承 HTTPS_PROXY/ALL_PROXY(大小寫別名一併檢查);再單獨測試「只啟 MCP、不觸發 Agent 對話」是否能在 /tools 看到 aws___search_documentation 等工具。對照本站GPT‑5.5 Codex 終端分流一文,方法論相同,只是把模型 API 換成 AWS MCP 與 SigV4 鏈路。
npm、uv 與 PyPI:為何要獨立一桶
uvx mcp-proxy-for-aws@latest 每次啟動都可能觸發 registry 解析與 tarball 下載,流量曲線與 MCP 長連線完全不同。若與 AWS API 共用自動測速組,常出現「CLI 身份驗證成功、IDE 卻載入不了工具」的分裂現象。請把 registry.npmjs.org、PyPI 鏡像與 astral.sh(安裝 uv 時)一併納入 AWS-DEV-REGISTRY 桶,並參考npm registry 與 tarball CDN 分流做長尾維護。
Skills 與 Plugins 若透過套件管理器安裝,也應落在同一桶,避免 Agent 對話時背景更新吃掉 MCP 握手頻寬。
AWS API、SigV4 與常見驗證錯誤
託管 MCP 使用 IAM 與 SigV4。文件列出的 ExpiredTokenException、InvalidSignatureException 等多半是憑證或本機時鐘問題;但若代理鏈在中途改寫請求體,也可能觸發簽名不符。排查時請先確認直連與代理行為一致,再刷新 aws login 並重啟 MCP 客戶端。
區域 API 規則請與 MCP 端點分開:例如連線 us-east-1 MCP,卻在對話中要求「列出 eu-west-1 的 EC2」——控制面流量會改走 ec2.eu-west-1.amazonaws.com。僅覆蓋單一 Region 的規則會讓你誤以為 AWS MCP Server 故障。可對照Slack 與 AWS CDN 分流中對 AWS 邊緣主機的拆法,把「閘道型 HTTPS」與「區域 API」分開觀察。
規則順序:寫了 api.aws 卻不生效?
Clash Meta/Mihomo 採自上而下命中即停。常見錯誤是:前面 GEOIP 或公司直連規則先把 amazonaws.com 送走,後面的 MCP 精準規則永遠輪不到。對 AWS Agent Toolkit 這類長期自動化場景,請把連線紀錄中驗證過的 DOMAIN放在企業必需直連之後、過寬第三方合集之前;使用 Rule Providers 時再檢查合輯順序。
TUN 模式與 uvx 子進程:決策鏈是否一致
許多開發者只在 IDE 開系統代理,終端裡的 uvx 卻未進 TUN。請在重現「MCP 初始化」時同時觀察:① IDE 進程;② uvx/mcp-proxy-for-aws 子進程。若紀錄只出現其中一類 hostname,先對齊 TUN 或 shell 代理變數,再調規則。macOS 終端對照可讀macOS 終端代理環境變數。
DNS 與 fake-ip:解析鏈不一致的間歇逾時
MCP 與 SigV4 都假設本機時間與解析穩定。若 fake-ip 與終端解析器不一致,會出現「規則命中欄與實際握手目標不符」的幽靈逾時。請確認 Clash Verge Rev、IDE 與 aws CLI 描述同一解析鏈;必要時對照連線與 DNS 排查。
QUIC/HTTP3 與企業中介
部分環境對 UDP 路徑不完整,會讓文件站或 CDN 特別慢,進而拖垮 MCP 啟動超時計時。若僅 Agent 工具載入慢、一般瀏覽尚可,可做單因子對照並參考QUIC/HTTP3 排查。
與 Codex、OpenClaw 文章的差異化閱讀
本站Codex/GPT‑5.5與OpenClaw文聚焦模型 API 與通用 Agent CLI;本篇鎖定2026 年 5 月 AWS 新工具鏈:託管 AWS MCP Server、mcp-proxy-for-aws 與區域 AWS API。三篇可並讀——對象不同,並行拆桶的方法相同。
自檢清單:按順序勾選
- 移除舊版 aws-api/aws-knowledge MCP 設定,改用託管端點與
mcp-proxy-for-aws@latest。 - 在 Verge Rev 紀錄中分離 MCP(
api.aws)、registry/tarball、amazonaws.com控制面 hostname。 - 建立三類以上策略組並避免 tarball 與 MCP 共用 url-test 自動切換。
- 確認 uvx 子進程與 IDE 使用同一代理/TUN 決策鏈。
- 刷新 AWS 憑證後重啟 MCP 客戶端,以
/tools驗證工具是否載入。
常見問題
首次連線官方說可能要幾分鐘,代理會讓它更久嗎?
會。若 npm 下載與 MCP 握手串在同一慢節點或互相搶頻寬,牆鐘時間會疊加。請先拆桶並固定 MCP 桶節點做對照,再判斷是否仍超出文件所述正常範圍。
文件工具不需驗證,還要分流嗎?
建議仍獨立觀察:docs.aws.amazon.com 與 MCP 端點的 CDN 行為不同;大量文件抓取可能與 API 呼叫並行,分桶可避免假逾時。
總結與引導下載
跟上二〇二六年五月的 AWS Agent Toolkit 與 GA 的 AWS MCP Server 時,多數「工具載入失敗」並非單一服務宕機,而是 uvx/npm CDN、託管 MCP HTTPS 與 AWS API 並行競爭出口策略。請先用 Clash Verge Rev 把連線紀錄對齊到 hostname,再以規則順序與MCP 分流命名拆桶,才能區分卡住的是套件、MCP 端點還是 SigV4 控制面,而不是盲目換節點。
相較之下,部分僅提供「一鍵連線」的類似程式較難把 api.aws 與 registry.npmjs.org 拆成可版本化的規則;當 AI coding agent 同時拉代理程式與長連線 MCP 時,排查成本會長期偏高。
Clash/Mihomo 生態則把策略組、DNS 與稽核紀錄放在同一套語意裡;對需要穩定使用 Agent Toolkit for AWS 的開發者,通常更能適應上游端點與 registry 的變化。
若希望先取得與 Mihomo/Clash Meta 相容的客戶端,再依本篇完成 MCP 與 API 分流微調,請開啟本站客戶端下載頁選擇對應平台建置。