📌 项目地址:aws/agent-toolkit-for-aws | ⭐ 1,081 颗星 | 🔧 Python | 📜 未标注
为什么需要这个项目
AI 编码助手(Claude Code、Codex、Cursor、Kiro 等)能生成代码,但不能直接理解 AWS 账户状态、调用 API、部署资源。开发者通常需要手动切换终端、编写繁琐的凭证配置,或依赖非官方的第三方 MCP 服务器。
Agent Toolkit for AWS 是 AWS 官方发布的 MCP(Model Context Protocol)服务器配置、技能和插件合集,专门为 AI coding agents 提供与 AWS 交互的标准化能力。它直接嵌入主流编码工具,让 AI 能执行“查询 S3 桶”、“部署 CDK 堆栈”、“分析 CloudWatch 日志”等实际操作。
实际用法:四种主流编码工具的集成方式
Claude Code(最完善的支持)
Claude Code 已内置官方插件市场,直接通过 /plugin install 命令安装:
- aws-core:覆盖服务选择、CDK/CloudFormation、无服务器、容器、存储、可观测性、计费、SDK 使用和部署。
/plugin install aws-core@claude-plugins-official - aws-agents:基于 Amazon Bedrock 和 AgentCore 构建 AI 代理。
/plugin install aws-agents@claude-plugins-official - aws-data-analytics:数据湖、分析、ETL 工作流(S3 Tables、Glue、Athena)。
/plugin install aws-data-analytics@claude-plugins-official - aws-agents-for-devsecops:事件调查、代码审查、UAT、漏洞扫描、渗透测试。
/plugin marketplace add aws/agent-toolkit-for-aws
/plugin install aws-agents-for-devsecops
/reload-plugins
如果提示 Plugin not found,先更新本地市场索引:
/plugin marketplace update claude-plugins-official
Codex(终端 IDE)
终端中执行:
codex plugin 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 面板安装所需插件。
Kiro(MCP 配置)
在 .kiro/settings/mcp.json 中添加 AWS MCP 服务器的定义(使用 uvx 运行代理):
{
"mcpServers": {
"aws": {
"command": "uvx",
"args": [
"mcp-proxy-for-aws@1.6.2",
"https://aws-mcp.us-east-1.api.aws/mcp",
"--metadata", "AWS_REGION=us-west-2"
]
}
}
}
建议锁定具体版本(如 @1.6.2)以避免意外更新。
与其他方案的差异
- 官方 vs 第三方:市面上已有社区维护的 AWS MCP 服务器,但无法保证与 AWS 服务的最新接口同步,且缺乏安全性审计。Agent Toolkit for AWS 由 AWS 直接支持,每个插件捆绑了经过测试的 MCP 配置和技能。
- 插件 vs 手动配置:过去需要在 Claude Code 等工具中手动编写 MCP 配置 JSON、处理凭证、定义工具列表。该项目通过
/plugin install一步完成,且内置“技能”层(如 DevSecOps 中能自动执行渗透测试)。 - 多平台一次构建:所有插件来自同一个仓库,Claude Code、Codex、Cursor 使用不同的安装方式但共享同一套核心 MCP 服务器,降低了维护成本。
注意事项
- 许可证:仓库根目录有 LICENSE 文件,但 README 未明确指明;使用前务必查看仓库许可条款(推测为 Apache 2.0 或 AWS 特定许可),特别是商业使用场景。
- 安全与权限:AI 代理通过插件获得的 AWS 权限由当前用户的 IAM 凭证决定。插件本身不会自动提升权限,但若 AI 被诱导执行危险操作(如删除存储桶),后果由用户承担。建议结合 AWS IAM 最小权限原则使用。
- DevSecOps 插件需要额外初始设置:安装后需运行
/aws-agents-for-devsecops:setup完成环境配置。 - 区域限制:Kiro 配置示例中指定了
AWS_REGION=us-west-2,实际使用时需根据自身需求调整。部分 MCP 端点(如aws-mcp.us-east-1.api.aws)可能仅在特定区域可用。 - 版本锁定:README 强调“It is recommended to pin to a specific version”,尤其是使用
uvx运行代理时,防止因自动升级导致不兼容。
如果你正在使用 Claude Code、Codex、Cursor 或 Kiro 需要频繁操作 AWS,这个官方工具包能显著减少上下文切换,让 AI 从“代码编写者”变成“云操作员”。但也要警惕将敏感权限交给 AI 代理带来的风险。