AWS MCP Servers (Official)

什么是 AWS MCP Servers (Official)？

AWS MCP Servers (Official) 即 awslabs/mcp 仓库：一套开源的 AWS MCP server 软件包，为 AI 助手提供最新的 AWS 文档、最佳实践，以及面向 Lambda、EKS、DynamoDB、CloudWatch 等服务的工具。

这个采用 Apache-2.0 许可的 monorepo 包含 50 多个专用服务器，每个都通过 uvx 单独安装。仓库 README 还指向托管版 AWS MCP Server：由 AWS 运行的托管远程端点，将 AWS API 访问与文档搜索结合在一起。AWS 现在推荐在生产环境中使用 Agent Toolkit for AWS（其中包含该托管服务器）；开源服务器仍可继续使用，并持续接受贡献。

如何使用 AWS MCP Servers (Official)？

把 AI 客户端连接到 AWS 有两种方式：运行某个本地开源服务器，或连接托管的 AWS MCP Server。

本地服务器（awslabs/mcp）。 README 中的前置条件：

1. 从 Astral 安装 uv。
2. 使用 uv python install 3.10 安装 Python。
3. 配置可访问所需服务的 AWS 凭证。
4. 将服务器添加到 MCP 客户端配置中。

本页展示的配置添加的是 Amazon Bedrock Knowledge Bases Retrieval 服务器：

{
  "mcpServers": {
    "awslabs.bedrock-kb-retrieval-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.bedrock-kb-retrieval-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-profile-name",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

把包名换成其他服务器即可，例如 awslabs.aws-documentation-mcp-server 或 awslabs.aws-iac-mcp-server。每个服务器的 README 都列出了各自的参数和变量。在 Windows 上，README 使用 uv tool run --from <package>@latest <package>.exe 代替 uvx。Docker 镜像发布在公共 AWS ECR 仓库（public.ecr.aws/awslabs-mcp/...）。

托管 AWS MCP Server。 使用 OAuth 时无需本地安装。为你的 IAM 用户或角色附加 AWSMCPSignInOAuthAccessPolicy 托管策略，然后让客户端指向区域端点，例如 https://aws-mcp.us-east-1.api.aws/mcp。如需 SigV4 认证，AWS 文档介绍了通过 uvx mcp-proxy-for-aws-cli@latest 运行的本地代理。

Claude Code

本地服务器，来自 awslabs README：

claude mcp add aws-docs uvx awslabs.aws-documentation-mcp-server@latest
claude mcp add aws-iac uvx awslabs.aws-iac-mcp-server@latest
claude mcp add aws-pricing uvx awslabs.aws-pricing-mcp-server@latest

使用 OAuth 的托管服务器，来自 AWS 文档：

claude mcp add aws-mcp https://aws-mcp.us-east-1.api.aws/mcp --transport http

也可以在项目根目录使用 .mcp.json 文件。

Claude Desktop

将托管服务器添加为远程 MCP 服务器，URL 为 https://aws-mcp.us-east-1.api.aws/mcp?oauth=initialize；或者把上面那样的本地 uvx 配置粘贴到 Claude Desktop 配置文件中。

Cursor

把 JSON 配置放到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）。README 提供了 Cursor 一键安装按钮。对于托管服务器，添加带 ?oauth=initialize 的远程 URL。

VS Code

在 VS Code 设置或 .vscode/mcp.json 中配置服务器。README 为每个服务器提供了 VS Code 一键安装按钮。

Codex

codex mcp add aws-mcp --url https://aws-mcp.us-east-1.api.aws/mcp?oauth=initialize

AWS MCP Servers (Official) 的主要功能

• AWS 官方来源：由 AWS Labs 以 Apache-2.0 许可发布。
• 覆盖面广：涵盖文档、基础设施即代码（CDK、CloudFormation）、容器（EKS、ECS、Finch）、无服务器、数据库（DynamoDB、Aurora、DocumentDB、Neptune、Redshift）、缓存、消息、成本和医疗健康等服务器。
• 按需选用：每个服务器都是独立的 PyPI 包，只加载与项目相关的工具。
• 本地 stdio 传输：开源服务器仅支持 stdio；SSE 支持已于 2025 年 5 月 26 日移除。
• 托管选项：托管 AWS MCP Server 提供基于 IAM 的权限、CloudTrail 审计日志和八个区域端点。
• 客户端指南：提供 Kiro、Cline、Cursor、Windsurf、VS Code、Claude Code 和 fx 的配置步骤，其中 Windsurf 使用 ~/.codeium/windsurf/mcp_config.json。

AWS MCP Servers (Official) 工具

工具取决于你安装的服务器。以下示例来自各 README：

• AWS Documentation MCP Server：read_documentation、search_documentation、read_sections、search_table 和 recommend，用于查找和阅读 AWS 文档。
• AWS API MCP Server：call_aws 执行经过校验的 AWS CLI 命令，suggest_aws_commands 根据自然语言请求推荐命令。其 README 现已说明它被托管 AWS MCP Server 取代。
• AWS Knowledge MCP Server（远程）：search_documentation、read_documentation、list_regions、get_regional_availability 和 retrieve_skill。
• 托管 AWS MCP Server：知识类工具如 aws___search_documentation 和 aws___retrieve_skill，以及 API 类工具 aws___run_script（在沙箱中运行可访问 AWS API 的 Python）、aws___get_presigned_url 和 aws___get_tasks。

AWS MCP Servers (Official) 的使用场景

• 获取最新的 AWS 答案：“Using the AWS Documentation MCP Server, explain how to configure Bedrock inline agents.”
• 基础设施即代码：借助 AWS IaC MCP Server 生成符合当前最佳实践的 CDK 或 CloudFormation。
• 成本估算：配合 AWS Pricing MCP Server 询问“What would be the estimated monthly cost for this CDK project?”
• 运维与排障：分析 CloudWatch 指标、告警和日志，或管理 EKS 和 ECS 部署。
• 数据库工作：通过 RDS Data API 查询 Aurora PostgreSQL 或 MySQL，或获取 DynamoDB 数据建模指导。
• 账户范围的任务：使用托管服务器的 aws___run_script 列出各服务的资源并检查其设置。

AWS MCP Servers (Official) 与替代方案对比

• 托管 AWS MCP Server 与本地 awslabs 服务器：使用 OAuth 时托管服务器无需本地进程，并在 CloudTrail 中记录调用。本地服务器在你的机器上运行，凭证保留在本机，并覆盖数据库、容器和医疗健康等专用服务。AWS 建议在切换时移除 aws-api-mcp-server 和 aws-knowledge-mcp-server，以免工具重复。
• AWS MCP (RafalWilinski)：面向 Claude Desktop 的社区 Node.js 服务器，使用本地凭证查询你的 AWS 环境，与 AWS 无关联。
• AWS MCP Server (alexei-led)：在 Docker 容器中运行 AWS CLI 命令的社区服务器。

AWS MCP Servers (Official) 常见问题排查

• 服务器无法启动或提示缺少参数：手动运行以查看错误，例如 timeout 15s uv tool run <MCP Name> <args>。
• 启动缓慢：@latest 后缀每次启动都会检查 PyPI。如在意加载时间，可去掉它并用 uv cache clean <tool> 管理缓存。
• Docker 中 env 值不生效：用 --env、--env-file 和 --volume 传递变量，因为 "env" 块不会传入容器。
• 托管服务器报 ExpiredTokenException：刷新凭证（aws login 或 aws sso login）并重启客户端。
• OAuth 登录后出现 400 错误：为你的 IAM 主体附加 AWSMCPSignInOAuthAccessPolicy 托管策略。