Aws Claw: AWS AI 어시스턴트 🤖❤️☁️

Aws Claw는 Visual Studio Code(및 Google Antigravity, Windsurf 등을 포함한 포크 버전)용 확장 프로그램으로, 채팅 환경에서 AWS 상호 작용을 가능하게 합니다. 기존 자격 증명을 사용하여 자연어로 AWS 리소스를 검사하고 운영하세요. 이 확장 프로그램은 사용자를 대신하여 작업을 직접 실행하는 AWS 인식 도구를 제공합니다.

💬 채팅 모드

• 에이전트 또는 계획 모드: 확장 프로그램은 AI 어시스턴트가 요청에 따라 호출할 수 있는 AWS 서비스 도구를 등록합니다. 질문을 하면 어시스턴트가 적절한 도구를 호출하여 데이터를 가져오거나 작업을 수행합니다. 대부분의 사용 사례에서 이 모드로 시작하는 것을 권장합니다.

• 질문 또는 편집 모드: 채팅 입력창에서 "@aws" 접두사를 사용하여 직접 질문하거나 명령을 내릴 수도 있습니다. 어시스턴트는 요청된 정보를 응답하거나 지정된 작업을 수행합니다. 빠른 쿼리나 간단한 작업, 또는 에이전트/계획 모드를 사용할 수 없는 경우 이 모드를 권장합니다.

Related MCP server: AWS MCP Server

🔌 MCP 지원

• Vscode: MCP 서버를 설정할 필요가 없습니다. Aws Claw는 Vscode Chat(Copilot)에 내장되어 있어 별도의 설정이 필요하지 않습니다. AWS 리소스에 대해 채팅을 시작하기만 하면 됩니다.

• Google Antigravity / Windsurf / 기타: 이러한 편집기를 Aws Claw와 연결하려면 로컬 MCP 서버가 필요합니다. 자세한 설정 지침은 README_MCP를 참조하세요.

🔑 지원되는 AWS 서비스

지원되는 AWS 서비스 및 작업의 전체 목록을 보려면 여기를 클릭하세요.

🤖 사용 가능한 도구

• 세션 및 STS: 프로필/리전/엔드포인트 관리, 자격 증명 새로 고침, GetCallerIdentity, 세션 토큰.

• S3: 버킷/객체 나열, 객체 가져오기/넣기/삭제.

• SQS 및 SNS: 큐/토픽 나열, 메시지 보내기/받기/삭제, 큐 URL 가져오기.

• EC2: 인스턴스, 이미지, VPC, 보안 그룹, 콘솔 출력 설명.

• Lambda 및 Step Functions: 함수 호출, 상태 머신 및 실행 나열.

• EMR: 클러스터, 단계, 스튜디오, 노트북 실행 및 확장 정책 설명.

• CloudWatch Logs: 로그 이벤트 검색 및 검색.

• CloudFormation: 스택 나열, 스택 리소스 및 이벤트 설명.

• RDS 및 RDS Data: DB 인스턴스/클러스터 나열; RDS Data API를 통해 SQL 실행.

• DynamoDB: 테이블 나열, 테이블 설명, 항목 스캔/쿼리.

• IAM 및 STS: ID 및 자격 증명 유틸리티.

• API Gateway, Glue: 서비스 관리 및 S3 호환 엔드포인트 지원.

• 파일 작업: 로컬 작업 공간 컨텍스트 작업.

❓ Q & A

인증

• Q: Aws Claw는 AWS에 어떻게 인증하나요? A: 로컬에 구성된 기존 AWS 자격 증명(AWS CLI 구성, SSO, 환경 변수 등)과 AWS SDK 공급자 체인을 사용합니다.

• Q: 내 AWS 자격 증명이 확장 프로그램에 의해 저장되나요? A: 아니요, 자격 증명은 VS Code 전역 상태 외부에 저장되지 않습니다. 명령 팔레트에서 캐시된 자격 증명을 새로 고치거나 지울 수 있습니다.

권한

• Q: 어떤 권한이 필요한가요? A: 확장 프로그램은 귀하의 계정 권한을 사용하여 AWS API를 호출합니다. 최소 권한 IAM 정책을 사용하고 변경 작업을 실행하기 전에 활성 프로필을 확인하세요.

• Q: 이 확장 프로그램을 여러 AWS 계정과 함께 사용할 수 있나요? A: 네, 상태 표시줄 AWS 선택기나 명령 팔레트의 명령을 사용하여 프로필을 전환할 수 있습니다.

비용

• Q: 이 확장 프로그램을 사용하는 데 비용이 발생하나요? A: 확장 프로그램 자체는 무료로 사용할 수 있지만, AWS API 호출은 사용량 및 AWS 요금 정책에 따라 비용이 발생할 수 있습니다.

보안

• Q: 내 AWS 자격 증명이 Copilot이나 다른 AI 서비스에 노출되나요? A: 아니요, 귀하의 AWS 자격 증명은 확장 프로그램에 의해 로컬에서 처리되며 외부 AI 서비스로 전송되지 않습니다.

안전

• Q: 확장 프로그램이 내 AWS 계정에서 의도하지 않은 작업을 수행할 가능성이 있나요? A: 확장 프로그램은 아래 작업을 실행하기 전에 항상 귀하의 확인을 받습니다:

  • put, post, upload, download, delete, copy, create, update, insert, commit, rollback, send, publish, invoke, start, execute.

  • List, get, describe, search, scan, query 작업은 읽기 전용이며 안전합니다.

• Q: 수행 중인 AWS API 호출을 볼 수 있나요? A: 네, "명령 기록" 패널과 "Aws Claw-Log"라는 출력 채널에서 AWS API 호출 기록을 볼 수 있습니다. 출력 채널을 열려면 보기 -> 출력으로 이동한 다음 드롭다운에서 "Aws Claw-Log"를 선택하세요. "명령 기록" 패널을 열려면 명령 팔레트에서 "Aws Claw: Open Command History" 명령을 클릭하세요. 기록을 파일로 내보내면 API 호출 응답을 볼 수 있습니다.

📺 스크린샷

⚙️ 필수 조건

• 로컬에 구성된 AWS 자격 증명(AWS CLI 구성, SSO, 환경 변수 또는 기타 지원되는 방법).

🏁 빠른 시작

1. Aws 자격 증명: 로컬에 AWS 자격 증명이 구성되어 있는지 확인하세요. AWS CLI를 사용하여 프로필이나 SSO를 설정할 수 있습니다.

2. 연결 테스트: 상태 표시줄에서 "🔌Aws"를 클릭하고 "Aws Claw: Test AWS Connection"을 실행하여 AWS 액세스를 확인하세요. 필요한 경우 기본 프로필, 리전 및 엔드포인트(Localstack용)를 설정할 수 있습니다.

3. Google Antigravity / Windsurf / 기타: 이러한 편집기를 Aws Claw와 연결하려면 로컬 MCP 서버가 필요합니다. 자세한 설정 지침은 README_MCP를 참조하세요.

4. 채팅 열기: 채팅을 열고(질문 또는 편집 모드에서 @aws 사용) 질문을 하세요. 예:

   • 내 S3 버킷 나열

   • /aws/lambda/my-fn에 대한 최신 CloudWatch 로그 이벤트 테일링

   • us-west-2의 EC2 인스턴스 설명

   • 내 SNS 토픽에 메시지 게시

5. 결과 검토: 어시스턴트가 적절한 도구를 호출하고 결과를 스트리밍하며 후속 작업을 제안합니다.

🧠 기술 설치

Aws Claw는 GitHub Copilot이 AWS 서비스와 작업하는 방법을 가르치는 일련의 에이전트 기술과 함께 제공됩니다. 다음 명령으로 설치하세요:

npx skills add necatiarslan/awsclaw

설치되면 에이전트 세션에서 기술을 사용할 수 있으며, 어시스턴트에게 모든 지원되는 서비스에 대한 심층적인 AWS 서비스 지식, 모범 사례 및 도구 사용 지침을 제공합니다.

👮 인증 및 보안

• 자격 증명: AWS SDK 공급자 체인을 통해 해결됩니다. 선택한 프로필은 VS Code 전역 상태에 저장되며 세션 전반에 걸쳐 다시 적용됩니다.

• 개인정보 보호: 자격 증명은 VS Code 전역 상태 외부에 저장되지 않습니다. 명령 팔레트에서 캐시된 자격 증명을 새로 고치거나 지울 수 있습니다.

• 권한: 어시스턴트는 귀하의 계정 권한을 사용하여 AWS API를 호출합니다. 최소 권한 IAM 정책을 사용하고 변경 작업을 실행하기 전에 활성 프로필을 확인하세요.

📋 할 일

• 더 많은 AWS 서비스 및 작업 추가.

  • Tier1 : ECS, EKS, Secrets Manager, Systems Manager, ECR, CloudWatch Metrics & Alarms

  • Tier2 : ElastiCache, EventBridge, Kinesis, Route53, EFS, Cloud Trail, KMS, ELB

  • Tier3 : X-Ray, Athena, Redshift

• AWS 관련 쿼리에 대한 자연어 이해도 향상.

• 더 나은 사용자 경험을 위한 Copilot과 같은 설정 패널.

💖 링크

• 이슈 및 기능 요청: https://github.com/necatiarslan/awsclaw/issues

• 스폰서: https://github.com/sponsors/necatiarslan

• 라이선스: MIT