
业务场景
想象一下,您是一家美国科技公司的 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
中):
perl
{
"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 格式。
php
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 开发之旅
构建无限, 探索启程!