aws/agent-toolkit-for-aws

来源：https://github.com/aws/agent-toolkit-for-aws

AWS Agent Toolkit

许可证 构建状态 (https://github.com/aws/agent-toolkit-for-aws/actions/workflows/build.yml) 状态 (https://github.com/aws/agent-toolkit-for-aws)

帮助AI编码智能体在AWS上构建、部署和管理应用程序。

AWS Agent Toolkit为AI编码智能体提供了与AWS服务协作所需的工具、知识和防护机制。它兼容开发者已使用的编码智能体——包括Claude Code、Codex、Cursor和Kiro。

快速开始

Claude Code

插件已在Anthropic官方市场中提供（claude-plugins-official），默认会添加到您的Claude Code安装中。使用以下命令从工具包安装支持的插件：

对于涵盖服务选择、CDK/CloudFormation、无服务器、容器、存储、可观测性、计费、SDK使用和部署的 aws-core：

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

提示： 如果遇到 Plugin not found，请先更新本地市场索引：

/plugin marketplace update claude-plugins-official

对于涵盖使用Amazon Bedrock和AgentCore在AWS上构建AI智能体的 aws-agents：

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

对于涵盖S3 Tables、AWS Glue和Athena数据湖、分析和ETL工作流的 aws-data-analytics：

/plugin install aws-data-analytics@claude-plugins-official

对于用于调查事件、审查代码并执行UAT以确认发布就绪、扫描代码漏洞以及使用AWS DevOps Agent和AWS Security Agent进行渗透测试的 aws-agents-for-devsecops：

`` /plugin marketplace add aws/agent-toolkit-for-aws /plugin install aws-agents-for-devsecops /reload-plugins

或者从Claude官方市场安装：

/plugin install aws-agents-for-devsecops@claude-plugins-official /reload-plugins

设置：

/aws-agents-for-devsecops:setup ``

Codex

在终端中：

codex plugin marketplace add aws/agent-toolkit-for-aws

然后启动Codex并运行 /plugins 以浏览并安装 aws-core 插件。

Cursor

将此仓库添加为团队市场：设置 → 插件 → 团队市场 → 添加市场 → 从仓库导入，指向 aws/agent-toolkit-for-aws。导入时，Cursor会索引 .cursor-plugin/marketplace.json 中列出的插件。

然后打开 插件 面板并安装 aws-core 插件（从这里开始），或根据需要安装 aws-agents 和 aws-data-analytics。每个插件都捆绑了AWS MCP Server配置和智能体技能。

Kiro

将AWS MCP Server添加到Kiro的MCP配置中（.kiro/settings/mcp.json）：

json { "mcpServers": { "aws": { "command": "uvx", "args": [ "[email protected]", "https://aws-mcp.us-east-1.api.aws/mcp", "--metadata", "AWS_REGION=us-west-2" ] } } }

注意： 建议固定到特定版本（例如 @1.6.2），以确保可重现的行为并防范供应链风险。我们建议定期检查PyPI (https://pypi.org/project/mcp-proxy-for-aws/) 以获取新的稳定版本并相应更新。

然后从此仓库安装技能：

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

先决条件： 您需要安装 uv (https://docs.astral.sh/uv/)。API调用和脚本执行需要本地配置好AWS账户凭证，但文档搜索和技能发现不需要。有关详细的设置说明，请参阅用户指南 (https://docs.aws.amazon.com/agent-toolkit/latest/userguide/)。

其他智能体

请参阅AWS MCP Server入门指南 (https://docs.aws.amazon.com/agent-toolkit/latest/userguide/getting-started-aws-mcp-server.html)，了解如何将AWS MCP Server与您的智能体进行配置。

然后从此仓库安装技能：

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

先决条件： 您需要安装 uv (https://docs.astral.sh/uv/)。API调用和脚本执行需要本地配置好AWS账户凭证，但文档搜索和技能发现不需要。有关详细的设置说明，请参阅用户指南 (https://docs.aws.amazon.com/agent-toolkit/latest/userguide/)。

包含的内容

插件

插件将AWS MCP Server配置和智能体技能捆绑在一起，为您的编码智能体提供一键安装。

插件目前适用于Claude Code、Codex和Cursor。对于其他智能体，请直接配置AWS MCP Server并从此仓库安装技能。

技能

智能体技能是经过精心组织的指令和参考资料包，帮助智能体完成特定的AWS任务。技能按需加载——智能体仅发现和检索与当前任务相关的内容。

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

浏览 skills/ 目录以查看所有可用的技能。

规则文件

推荐的项目级配置文件，用于告诉智能体如何最有效地使用AWS——例如，通过使用AWS MCP Server、发现可用的技能或在行动前搜索文档。

详情请参阅 rules/。

AWS MCP Server

AWS MCP Server (https://docs.aws.amazon.com/agent-toolkit/latest/userguide/understanding-mcp-server-tools.html) 是一个托管服务器，通过模型上下文协议让智能体访问AWS。它提供：

• 完整的AWS API覆盖 —— 通过单一经过身份验证的端点与300多个AWS服务中的任何一个进行交互。
• 沙盒脚本执行 —— 智能体可以在隔离环境中运行Python脚本，以执行复杂的多步骤操作。
• 实时文档访问 —— 无需身份验证即可搜索和检索当前的AWS文档、API参考和服务功能。
• 企业级控制 —— Amazon CloudWatch指标、用于智能体特定策略的IAM上下文密钥，以及AWS CloudTrail审计日志记录。

有关操作、可用工具、身份验证和受支持区域的详细信息，请参阅AWS MCP Server文档 (https://docs.aws.amazon.com/agent-toolkit/latest/userguide/understanding-mcp-server-tools.html)。

文档

• 用户指南 (https://docs.aws.amazon.com/agent-toolkit/latest/userguide/) —— 设置、配置和参考文档。
• AWS MCP Server工具 (https://docs.aws.amazon.com/agent-toolkit/latest/userguide/understanding-mcp-server-tools.html) —— 所有可用MCP工具的参考。

AWS Agent Toolkit与AWS Labs中MCP服务器、技能和插件的关系

2025年，AWS开始在AWS Labs (https://github.com/awslabs) 下发布MCP服务器、技能和插件。AWS Agent Toolkit是这些工具的后续版本。我们建议使用AWS Agent Toolkit，因为它提供关键功能，包括：

• IAM条件键，用于区分智能体操作和人类操作，因此您可以编写仅适用于智能体的策略。例如，您可以编写策略，仅允许通过MCP服务器执行只读操作，即使底层IAM角色允许执行写入操作。
• 每个请求的CloudWatch指标和CloudTrail审计日志记录，因此您可以监控和审计编码智能体的活动。
• 经过彻底端到端评估的智能体技能，因此您可以确信工作流能够成功完成。

AWS Labs (https://github.com/awslabs) 的MCP服务器、技能和插件将继续工作并接受贡献，随着时间的推移，AWS Labs中的最佳内容将迁移到AWS Agent Toolkit，以确保客户能够为其智能体访问最广泛的工具和指导。

许可证

本项目采用Apache-2.0许可证。详情请参阅 LICENSE。