让 AI 编码代理去碰 AWS,最怕两件事:一是模型对最新服务、最新 SDK 用法记忆过期,写的代码跑不起来;二是代理一旦拿到凭证,可能越过你本意去删资源、改配置,出了事没法追溯。靠代理自己瞎猜 AWS CLI 参数,往往既低效又危险。AWS 自己下场给出了官方解法:一套原厂维护的 MCP 服务器、skills 和 plugins,让代理在受控、可审计的前提下帮你在云上构建、部署、运维。

Agent Toolkit for AWS 就是这套官方工具箱,它接的是你已经在用的编码代理(Claude Code、Codex、Cursor、Devin、Kiro、fx 等),而不是另起炉灶。

项目基本信息

信息项详情
项目名称agent-toolkit-for-aws
GitHub地址https://github.com/aws/agent-toolkit-for-aws
项目描述AWS 官方出品的 MCP 服务器、skills 与 plugins 工具箱
作者aws
开源协议Apache License 2.0
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-23

一、项目介绍

Agent Toolkit for AWS 给 AI 编码代理提供在 AWS 上工作所需的工具、知识和护栏。它分三层:AWS MCP Server(托管服务,让代理通过统一认证端点调用 300+ AWS 服务,并带沙箱脚本执行和实时文档检索)、agent skills(按需加载的任务包,比如怎么用 CDK、怎么做 Bedrock 智能体)、plugins(把 MCP 配置和 skills 打包成一次安装)。它接的是开发者已经在用的代理,而不是要求换工具。

二、核心优势

第一,全服务覆盖。MCP Server 一条认证端点打通 300+ AWS 服务,不用为每个 API 手写适配。第二,实时文档。代理能直接检索当前版本文档和 API 参考,规避「记忆过期写错参数」。第三,沙箱执行。复杂多步操作可在隔离环境跑 Python 脚本。第四,企业级护栏。带 CloudWatch 指标、IAM 条件键(区分代理动作与人动作)、CloudTrail 审计日志,代理干了什么全程可追溯。第五,经过端到端评估的 skills。官方声称这些 skill 做过充分评测,工作流更可能一次跑通。

三、适用场景

适合用编码代理做云开发的团队:在 Claude Code 里让代理帮你写 CDK/CloudFormation、部署 Serverless、排查 incident;用 Bedrock 和 AgentCore 搭 AI 智能体;做数据湖 / ETL;甚至用 devsecops 插件让代理扫漏洞、跑渗透测试。对合规和审计有要求的团队,它的 IAM 条件键和 CloudTrail 日志是关键卖点。

四、安装教程

前置条件:装好 uv,并本地配置好有凭证的 AWS 账号(仅需文档检索和 skill 发现时可不配置凭证)。

Claude Code 下安装核心插件(已在官方 marketplace 默认添加):

/plugin install aws-core@claude-plugins-official

只装 skills(适用于 Kiro、fx、其他代理):

npx skills add aws/agent-toolkit-for-aws/skills

单独接 AWS MCP Server(以 Kiro 的 .kiro/settings/mcp.json 为例):

{
  "mcpServers": {
    "aws": {
      "command": "uvx",
      "args": ["mcp-proxy-for-aws-cli@latest", "https://aws-mcp.us-east-1.api.aws/mcp", "--metadata", "AWS_REGION=us-west-2"]
    }
  }
}

常见报错:Claude Code 报 Plugin not found 时,先 /plugin marketplace update claude-plugins-official 刷新本地索引;装 skill 报找不到 uv 时,先装 Astral 的 uv。凭证错误会直接体现在 MCP 调用失败上,确认本地 aws configure 已就绪。

五、使用示例

在 Claude Code 里让代理建一个 Lambda:

用 aws-core 帮我在 us-west-2 建一个处理 S3 事件的 Lambda,并写好 CDK 代码

装好 devsecops 插件后做发布前安全检查:

/aws-agents-for-devsecops:setup

接好 MCP Server 后,代理能直接问答「当前账号里有哪些未加密的 S3 桶」,并在你批准的动作范围内调用 API。整个过程中,每次请求都会留下 CloudTrail 记录,方便事后审计。

六、常见问题

问:它和 AWS Labs 里的那些 MCP/skills 什么关系?答:Agent Toolkit 是官方继任者,AWS Labs 的旧工具仍可用,优秀的会逐步迁过来。问:一定要接 MCP Server 吗?答:不,skills 和 MCP Server 相互独立,只用 skills 也能跑任务指引。问:支持哪些代理?答:插件已支持 Claude Code、Codex、Cursor、Devin;其他代理可直接配 MCP Server 并装 skills。问:代理会不会乱删资源?答:IAM 条件键能写「只允许通过 MCP 只读」,即使底层角色能写也能被收敛。

七、总结

Agent Toolkit for AWS 的价值是把「让代理安全、正确地用 AWS」这件事从社区拼凑变成了原厂工程化方案。它最值得称道的是护栏与审计:CloudTrail 日志、IAM 条件键让代理的动作可管、可追溯,而不是拿到凭证后无法无天。对已经在用编码代理做云开发的团队,它几乎是必装;代价是需要本地有 uv 和 AWS 凭证,且部分高级能力依赖特定代理插件。