aws/agent-toolkit-for-aws

AI 코딩 에이전트가 AWS에서 애플리케이션을 구축, 배포 및 관리할 수 있도록 지원합니다.

Agent Toolkit for AWS는 AI 코딩 에이전트가 AWS 서비스와 함께 작업하는 데 필요한 도구, 지식 및 가드레일 (guardrails)을 제공합니다. 이 툴킷은 개발자들이 이미 사용 중인 Claude Code, Codex, Cursor, Kiro를 포함한 코딩 에이전트와 함께 작동합니다.

플러그인은 공식 Anthropic 마켓플레이스 (claude-plugins-official)에서 사용할 수 있으며, 이는 Claude Code 설치 시 기본적으로 추가됩니다.
다음 명령어를 사용하여 툴킷에서 지원하는 플러그인을 설치하세요:

서비스 선택, CDK/CloudFormation, 서버리스 (serverless), 컨테이너 (containers), 스토리지 (storage), 관측성 (observability), 빌링 (billing), 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를 사용하여 데이터 레이크 (data lake), 분석 (analytics) 및 ETL 워크플로를 다루는 aws-data-analytics의 경우:

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

AWS DevOps Agent 및 AWS Security Agent를 사용하여 사고를 조사하고, 코드를 리뷰하며, 출시 준비를 위한 UAT를 실행하고, 코드의 취약점을 스캔하며, 침투 테스트 (penetration tests)를 수행하는 데 사용되는 aws-agents-for-devsecops의 경우:

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

터미널에서:

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

그 다음 Codex를 실행하고 /plugins를 실행하여 aws-core 플러그인을 찾아 설치하세요.

이 리포지토리를 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 설정과 에이전트 스킬 (agent skills)을 번들로 제공합니다.

AWS MCP Server를 Kiro MCP 설정(.kiro/settings/mcp.json)에 추가하세요:

{
"mcpServers": {
"aws": {
...

참고: 재현 가능한 동작을 보장하고 공급망 위험 (supply chain risks)을 방지하기 위해 특정 버전(예: @1.6.2)으로 고정(pin)하는 것을 권장합니다. 정기적으로 PyPI를 확인하여 새로운 안정 버전을 확인하고 그에 따라 업데이트할 것을 권장합니다.

그 다음 이 리포지토리(repository)에서 스킬을 설치하세요:

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

사전 요구 사항: uv가 설치되어 있어야 합니다. API 호출 및 스크립트 실행을 위해 자격 증명 (credentials)이 로컬에 구성된 AWS 계정이 필요하지만, 문서 검색이나 스킬 탐색 (skill discovery)에는 필요하지 않습니다. 자세한 설정 지침은 사용자 가이드를 참조하세요.

에이전트와 함께 AWS MCP Server를 구성하는 방법에 대한 지침은 AWS MCP Server 시작 가이드를 참조하세요.

그 다음 이 리포지토리에서 스킬을 설치하세요:

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

사전 요구 사항: uv가 설치되어 있어야 합니다. API 호출 및 스크립트 실행을 위해 자격 증명이 로컬에 구성된 AWS 계정이 필요하지만, 문서 검색이나 스킬 탐색에는 필요하지 않습니다. 자세한 설정 지침은 사용자 가이드를 참조하세요.

플러그인은 AWS MCP Server 설정과 에이전트 스킬을 코딩 에이전트(coding agent)를 위한 단일 설치 항목으로 번들링합니다.

플러그인	설명
aws-core	핵심 AWS 스킬 및 MCP Server 설정. 서비스 선택, CDK/CloudFormation, 서버리스 (serverless), 컨테이너 (containers), 스토리지 (storage), 관측성 (observability), 빌링 (billing), SDK 사용 및 배포를 다룹니다. 여기서 시작하세요.
...

플러그인은 현재 Claude Code, Codex 및 Cursor에서 사용할 수 있습니다. 다른 에이전트의 경우, AWS MCP Server를 직접 구성하고 이 리포지토리에서 스킬을 설치하세요.

에이전트 스킬 (Agent skills)은 에이전트가 특정 AWS 작업을 완료할 수 있도록 돕는 지침(instructions)과 참조 자료(reference materials)로 구성된 큐레이션된 패키지입니다. 스킬은 필요할 때(on demand) 로드됩니다. 즉, 에이전트는 현재 작업과 관련된 내용만을 발견하고 검색합니다.

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

사용 가능한 모든 스킬을 확인하려면 skills/ 디렉토리를 탐색하세요.

에이전트가 AWS를 가장 효과적으로 사용하는 방법(예: AWS MCP Server 사용, 사용 가능한 스킬 검색, 또는 작업을 수행하기 전 문서 검색 등)을 알려주는 권장 프로젝트 수준 설정 파일(project-level configuration files)이 있습니다.

자세한 내용은 rules/를 참조하세요.

AWS MCP Server는 모델 컨텍스트 프로토콜 (Model Context Protocol, MCP)을 통해 에이전트에게 AWS 접근 권한을 부여하는 관리형 서버입니다. 다음과 같은 기능을 제공합니다:

전체 AWS API 커버리지 (Full AWS API coverage)— 단일 인증 엔드포인트를 통해 300개 이상의 모든 AWS 서비스와 상호 작용할 수 있습니다.
샌드박스형 스크립트 실행 (Sandboxed script execution)— 에이전트는 복잡한 다단계 작업을 위해 격리된 환경에서 Python 스크립트를 실행할 수 있습니다.
실시간 문서 접근 (Real-time documentation access)— 인증 없이도 최신 AWS 문서, API 참조 및 서비스 기능(service capabilities)을 검색하고 가져올 수 있습니다.
엔터프라이즈 제어 (Enterprise controls)— Amazon CloudWatch 메트릭, 에이전트 전용 정책을 위한 IAM 컨텍스트 키(IAM context keys), 그리고 AWS CloudTrail 감사 로깅(audit logging)을 지원합니다.

작동 방식, 사용 가능한 도구, 인증 및 지원되는 리전(Regions)에 대한 자세한 내용은 AWS MCP Server 문서를 참조하세요.

• 사용자 가이드 (User guide) — 설정, 구성 및 참조 문서.
• AWS MCP Server 도구 (AWS MCP Server tools) — 사용 가능한 모든 MCP 도구에 대한 참조.

2025년, AWS는 AWS Labs의 일환으로 MCP 서버, 스킬 및 플러그인을 출시하기 시작했습니다. Agent Toolkit for AWS는 해당 도구들의 후속 제품입니다. Agent Toolkit for AWS는 다음과 같은 핵심 기능을 제공하므로 사용을 권장합니다:

• 에이전트 작업과 사람의 작업을 구분하는 IAM 조건 키 (condition keys)를 제공하여, 에이전트에게만 적용되는 정책을 작성할 수 있습니다. 예를 들어, 사용자의 기본 IAM 역할 (IAM role)이 쓰기 작업을 수행할 수 있더라도, MCP 서버를 통해서는 읽기 전용 작업만 허용하도록 정책을 작성할 수 있습니다).
• 모든 요청에 대한 CloudWatch 메트릭 (metrics) 및 CloudTrail 감사 로깅 (audit logging)을 제공하여, 코딩 에이전트의 활동을 모니터링하고 감사할 수 있습니다.
• 철저한 엔드 투 엔드 (end-to-end) 평가를 거친 에이전트 기술 (skills)을 제공하여, 워크플로가 성공적으로 완료될 것이라고 확신할 수 있습니다.

AWS Labs의 MCP 서버, 기술 (skills), 플러그인 (plugins)은 계속 작동하며 기여를 수용할 것입니다. 시간이 지남에 따라 고객이 에이전트를 위한 가장 폭넓은 도구 세트와 가이드를 이용할 수 있도록, AWS Labs의 최상급 기능들이 Agent Toolkit for AWS로 전환될 예정입니다.

이 프로젝트는 Apache-2.0 라이선스 하에 라이선스가 부여됩니다. 자세한 내용은 LICENSE를 참조하십시오.