業務場景
想象一下,您是一家美國科技公司的 IT 架構師,公司剛剛決定將業務擴展到中國市場。作為技術負責人,您需要規劃如何將現有的基于亞馬遜云科技的應用遷移到中國區域。然而,您很快發現中國區的云服務環境與您熟悉的全球區域存在一些差異:服務終端節點不同,ARN 格式不同,部分功能特性也有所不同,并且有獨立的文檔站點。
這種情況下,您需要一個高效的方式來了解中國區亞馬遜云科技的特性和限制。這正是亞馬遜云科技文檔 MCP 服務器的中國區支持功能發揮作用的地方。
📢限時插播:Amazon Q Developer 來幫你做應用啦!
🌟10分鐘幫你構建智能番茄鐘應用,1小時搞定新功能拓展、測試優化、文檔注程和部署
?快快點擊進入《Agentic Al 幫你做應用 -- 從0到1打造自己的智能番茄鐘》實驗
免費體驗企業級 AI 開發工具的真實效果吧
構建無限,探索啟程!
技術背景
Model Context Protocol (MCP) 是一個開放協議,它標準化了應用程序如何向 AI 智能體提供上下文信息。MCP 使 AI 智能體能夠與本地運行的 MCP 服務器通信,這些服務器提供額外的工具和資源來擴展 AI 智能體的能力。
aws-documentation-mcp-server
是亞馬遜云科技推出的官方文檔 MCP 服務器,它允許用戶訪問亞馬遜云科技官方文檔、搜索內容以及獲取相關推薦。然而,之前的版本僅支持海外區亞馬遜云科技文檔,不支持中國區文檔。
最近,awslabs/mcp
倉庫中的 PR #519 解決了這一問題,通過添加對亞馬遜云科技中國區文檔的支持,使跨國企業能夠更準確地獲取亞馬遜云科技中國區的文檔信息,從而更好地規劃其中國市場戰略。
實際應用場景
考慮以下幾個真實業務場景:
-
全球電商平臺進入中國:一家美國電商巨頭計劃將其基于 Amazon Lambda 和 Amazon DynamoDB 的訂單處理系統部署到中國。他們需要了解這些服務在中國區的可用性、性能特點以及合規要求。
-
跨國金融服務本地化:一家歐洲金融科技公司使用 Amazon Aurora 構建其核心交易系統,現在需要將系統部署到中國以服務當地客戶,同時確保符合中國金融監管要求。
-
數據合規與本地化存儲:跨國企業需要了解中國區數據存儲的特殊合規要求,以及如何配置 Amazon S3 以符合這些要求。
-
混合云架構設計:企業需要設計一個能夠同時在全球區域和中國區域高效運行的架構,需要了解兩個區域之間的網絡連接選項和最佳實踐。
配置與使用方法
配置環境變量
要使用亞馬遜云科技中國區文檔支持功能,您需要設置環境變量 AWS_DOCUMENTATION_PARTITION
為 aws-cn
。這將使 MCP 服務器切換到亞馬遜云科技中國模式,提供適用于中國區的文檔工具。
配置示例
以下是配置 MCP 服務器以訪問中國區文檔的示例(以使用 Amazon Q Developer CLI 為例,配置在~/.aws/amazonq/mcp.json
中):
{"mcpServers": {"awslabs.aws-documentation-mcp-server": {"command": "uvx","args": ["awslabs.aws-documentation-mcp-server@latest"],"env": {"AWS_DOCUMENTATION_PARTITION": "aws-cn"}}}
}
對于需要同時比較全球區域和中國區域差異的跨國企業,可以設置兩個不同的 MCP 服務器實例:{"mcpServers": {"aws_docs": {"command": "uvx","args": ["awslabs.aws-documentation-mcp-server@latest"]},"aws_cn_docs": {"command": "uvx","args": ["awslabs.aws-documentation-mcp-server@latest"],"env": {"AWS_DOCUMENTATION_PARTITION": "aws-cn"}}}
}
可用工具
當 AWS_DOCUMENTATION_PARTITION
設置為 aws-cn
時,以下工具可用:
-
get_available_services
:獲取中國區可用的亞馬遜云科技服務列表。
get_available_services() → str
-
read_documentation
:獲取并轉換亞馬遜云科技中國區文檔頁面為 Markdown 格式。
read_documentation(url: str, max_length: int, start_index: int) → str
注意:中國區模式下不支持 search_documentation
和 recommend
工具,這些工具僅在海外模式下可用。
實際應用示例
假設您是一家美國金融科技公司的架構師,需要了解 Amazon Aurora 在中國區與全球區的差異,以評估將現有系統遷移到中國的可行性:
1)使用 Amazon Q Developer CLI 作為 MCP 主機,將上述 JSON 配置保存在~/.aws/amazonq/mcp.json
文件中。
2)啟動 Amazon Q Developer CLI 與文檔 MCP 服務器。
3)您可以通過 /tools
命令查看 MCP 服務器支持的工具列表。
4)輸入業務問題:我們公司計劃將基于 Aurora 的金融系統部署到中國,請幫我分析 Aurora 在中國區與海外區的主要差異及合規注意事項
。
5)Amazon Q Developer CLI 會調用文檔 MCP 服務器提供的工具,先獲取中國區可用服務的列表和文檔鏈接,然后閱讀對應的文檔。
6)由于同時配置了海外區的文檔 MCP 服務器,系統也會查詢海外區文檔進行對比。
7)最終為您提供詳細的差異分析和合規建議,幫助您做出明智的架構決策。
業務價值與結論
亞馬遜云科技文檔 MCP 服務器的中國區文檔支持功能為計劃進入中國市場的跨國企業提供了顯著價值:
-
降低市場進入風險:提前了解中國區云服務的特性和限制,避免在項目后期發現架構不兼容的問題。
-
加速本地化進程:快速獲取準確的中國區服務信息,縮短技術調研時間,加速產品本地化。
-
優化合規策略:了解中國特有的數據合規要求,提前規劃合規架構,避免合規風險。
-
降低技術決策成本:通過直接比較全球區和中國區的服務差異,做出更明智的技術選擇,避免不必要的重構成本。
-
提升團隊協作效率:為全球和中國本地團隊提供統一的文檔訪問方式,促進跨區域技術團隊的有效協作。
對于計劃在中國開展業務的跨國企業來說,這一功能不僅是一個技術工具,更是一個戰略資產,能夠幫助企業更好地理解中國市場的技術環境,制定更符合本地需求的云戰略,最終實現業務在中國的成功落地與發展。
隨著中國數字經濟的快速發展和云計算市場的不斷擴大,這類支持跨區域部署的工具將變得越來越重要,為全球企業進入中國市場提供更加便捷的技術支持。
*前述特定亞馬遜云科技生成式人工智能相關的服務僅在亞馬遜云科技海外區域可用,亞馬遜云科技中國僅為幫助您了解行業前沿技術和發展海外業務選擇推介該服務
本篇作者
本期最新實驗為《Agentic AI 幫你做應用 —— 從0到1打造自己的智能番茄鐘》
? 自然語言玩轉命令行,10分鐘幫你構建應用,1小時搞定新功能拓展、測試優化、文檔注釋和部署
💪 免費體驗企業級 AI 開發工具,質量+安全全掌控
??[點擊進入實驗] 即刻開啟 AI 開發之旅
構建無限, 探索啟程!