用途
Agent Toolkit for AWS 旨在帮助 AI 编程代理在 AWS 上构建、部署和管理应用程序。它为代理提供与 AWS 服务协作所需的工具、知识和防护措施,支持开发者常用的编码代理,包括 Claude Code、Codex、Cursor、Kiro 和 fx。该工具包是 AWS Labs 中 MCP 服务器、技能和插件的后继版本。
主要能力
工具包包含插件、Agent 技能、推荐配置规则以及 AWS MCP Server。
插件(Plugins)
插件将 AWS MCP Server 配置和代理技能打包为单次安装,目前适用于 Claude Code、Codex 和 Cursor。可用插件包括:
- aws-core:涵盖服务选择、CDK/CloudFormation、无服务器、容器、存储、可观测性、计费、SDK 使用和部署。
- aws-agents:涵盖使用 Amazon Bedrock 和 AgentCore 在 AWS 上构建 AI 代理。
- aws-data-analytics:涵盖使用 S3 Tables、AWS Glue 和 Athena 的数据湖、分析和 ETL 工作流。
- aws-agents-for-devsecops:用于调查事件、审查代码并执行 UAT 以确认发布就绪、扫描代码漏洞,以及使用 AWS DevOps Agent 和 AWS Security Agent 运行渗透测试。
- aws-startup-advisor:涵盖面向初创公司的架构、成本、安全及 AWS Activate 指导,以及从 Azure、GCP、Heroku 和 OpenAI、Gemini 等 AI 栈迁移到 AWS。
Agent 技能(Skills)
Agent 技能是精心整理的指令和参考资料包,帮助代理完成特定的 AWS 任务。技能按需加载,代理仅发现并检索与当前任务相关的内容。技能目录为 repository 中的 skills/。
推荐配置规则(Rules)
推荐的项目级配置文件,指导代理如何最有效地使用 AWS,例如通过 AWS MCP Server、发现可用技能或在操作前搜索文档。详见 rules/ 目录。
AWS MCP Server
AWS MCP Server 是一个托管服务器,通过 Model Context Protocol 让代理访问 AWS,提供:
- 完整 AWS API 覆盖:通过单个经过身份验证的端点与 300+ AWS 服务交互。
- 沙盒脚本执行:代理可在隔离环境中运行 Python 脚本,用于复杂的多步操作。
- 实时文档访问:无需身份验证即可搜索和检索当前的 AWS 文档、API 参考和服务能力。
- 企业管控:Amazon CloudWatch 指标、面向代理特定策略的 IAM 上下文键,以及 AWS CloudTrail 审计日志。
使用方式
在终端中使用 AWS CLI 直接使用
可参照 AWS CLI 集成指南进行设置、配置和使用。
通过官方 Anthropic 市场安装插件(Claude Code)
插件在官方 Anthropic 市场(claude-plugins-official)中提供,该市场默认添加到 Claude Code 安装中。使用命令安装支持的插件:
- aws-core:
/plugin install aws-core@claude-plugins-official - aws-agents:
/plugin install aws-agents@claude-plugins-official - aws-data-analytics:
/plugin install aws-data-analytics@claude-plugins-official - aws-agents-for-devsecops:
/plugin install aws-agents-for-devsecops@claude-plugins-official - aws-startup-advisor 需从此仓库的市场安装:
/plugin marketplace add aws/agent-toolkit-for-aws,然后/plugin install aws-startup-advisor@agent-toolkit-for-aws提示:如果出现“Plugin not found”,先更新本地市场索引:/plugin marketplace update claude-plugins-official。
Codex
在终端中运行:codex marketplace add aws/agent-toolkit-for-aws,然后启动 Codex 并运行 /plugins 浏览并安装 aws-core 插件。
Cursor
在 Settings → Plugins → Team Marketplaces → Add Marketplace → Import from Repo 中,将此仓库添加为团队市场,指向 aws/agent-toolkit-for-aws。导入时 Cursor 会索引 .cursor-plugin/marketplace.json 中列出的插件。然后打开 Plugins 面板安装 aws-core 插件(从这里开始),或根据需要安装 aws-agents 和 aws-data-analytics。每个插件都捆绑了 AWS MCP Server 配置和代理技能。
Kiro
设置包含两个独立部分:AWS MCP Server(用于运行时 AWS API 访问和文档搜索)和本地技能(用于任务特定的代理指导)。技能不需要 MCP 服务器,MCP 服务器也不提供本地安装的技能。
- 将 AWS MCP Server 添加到 Kiro MCP 配置(.kiro/settings/mcp.json):
{
"mcpServers": {
"aws-mcp": {
"command": "uvx",
"args": ["mcp-proxy-for-aws@latest"]
}
}
}
- 从此仓库安装技能:
npx @aws/agent-toolkit@latest install-skills --agent kiro技能文件安装到 ~/.kiro/skills/(全局)或 .kiro/skills/(项目级)。每个技能是一个目录,包含 SKILL.md 文件,可选包含 references/ 子目录。Kiro 自动发现已安装技能并在任务匹配时按需激活。 先决条件:需要安装 uv。进行 API 调用和脚本执行需要配置本地凭据的 AWS 账户,但文档搜索或技能发现不需要。详细设置参见用户指南。
fx
设置与 Kiro 相同的两个独立部分。
- 从终端添加 AWS MCP Server:
fx mcp add aws-mcp -- uvx mcp-proxy-for-aws@latest。fx 将 MCP 服务器存储在 ~/.fx/mcp.json 中。也可手动添加到 ~/.fx/mcp.json,fx 使用 mcp 键而非 mcpServers,用 type 选择传输方式,单个 command 数组存放可执行文件及参数。如果编辑文件时已有会话打开,运行 /mcp reload 拾取更改。 - 安装技能:
npx @aws/agent-toolkit@latest install-skills --agent fx。这会将技能文件安装到 .fx/skills/(项目级);添加 -g 安装到 ~/.fx/skills/(全局)。fx 还会发现已为其他代理安装在 .agents/skills/、.claude/skills/ 和 .codex/skills/ 中的技能。fx 在启动时读取技能元数据,当你或代理调用时加载技能指令;在编辑器中输入 $ 或运行 /skills 浏览已安装内容。
其他代理
对于其他代理,直接配置 AWS MCP Server 并从此仓库安装技能。
适用场景
适用于需要 AI 编码代理在 AWS 上构建、部署、管理应用或进行数据分析、DevSecOps、初创公司架构咨询等任务的开发者。支持 Claude Code、Codex、Cursor、Kiro、fx 等常见编码代理。
与 AWS Labs 的关系
2025 年,AWS 开始作为 AWS Labs 的一部分发布 MCP 服务器、技能和插件。Agent Toolkit for AWS 是这些工具的后继者。推荐使用 Agent Toolkit for AWS,因为它提供以下关键特性:
- IAM 条件键,区分代理操作和人工操作,可编写仅适用于代理的策略。例如,即使底层 IAM 角色可以执行写入操作,也可编写策略仅允许通过 MCP 服务器进行只读操作。
- 每个请求的 CloudWatch 指标和 CloudTrail 审计日志,可监控和审计编码代理活动。
- 经过全面端到端评估的 Agent 技能,确保工作流成功完成。 AWS Labs MCP 服务器、技能和插件将继续工作并接受贡献,随着时间的推移,AWS Labs 中的最佳工具将转移到 Agent Toolkit for AWS。
限制
资料未提供关于收费、价格或具体平台限制的详细信息。使用需要安装 uv(针对 Kiro 和 fx 的本地技能部分),进行 API 调用和脚本执行需要配置本地凭据的 AWS 账户。详细操作、可用工具、身份验证和支持区域参见 AWS MCP Server 文档。
许可
本项目采用 Apache-2.0 许可证。