Skip to main content
Glama

⚡ AWS-Auth

빠르고 지능적인 AWS SSO 인증 및 Model Context Protocol (MCP) 서버

CI Release License: MIT Python Version MCP Ready

AWS SSO 로그인 피로를 없애세요. 보일러플레이트 구성 없이 지능형 역할 우선순위, 원자적 자격 증명 캐싱, 네이티브 AI 페어 프로그래밍 통합을 제공합니다.

빠른 시작왜 aws-auth인가?AI / MCP 통합주요 기능문서


  ┌───────────────────────┐       ┌────────────────────────┐       ┌───────────────────────┐
  │  IAM Identity Center  │ ────> │       aws-auth         │ ────> │  ~/.aws/credentials   │
  │     (AWS SSO OIDC)    │       │  (Smart Role Selector) │       │ (Strict 0600 POSIX)   │
  └───────────────────────┘       └───────────┬────────────┘       └───────────┬───────────┘
                                              │                                │
                                  ┌───────────▼────────────┐       ┌───────────▼───────────┐
                                  │   MCP Server (stdio)   │       │ Terraform / K8s / CLI │
                                  │ (Claude / Cursor / AI) │       │ (Instant Compatibility)│
                                  └────────────────────────┘       └───────────────────────┘

💡 왜 대안 대신 aws-auth인가?

기능

aws-auth

공식 aws sso login

granted / assume

aws-vault

제로 구성 계정 검색

자동

❌ 수동 ~/.aws/config 필요

⚠️ 부분적

❌ 수동

Model Context Protocol (MCP)

네이티브 내장

❌ 없음

❌ 없음

❌ 없음

1초 MRU / 고정 로그인

지능형 우선순위

❌ 없음

⚠️ 기록 프롬프트

❌ 없음

실시간 부분 문자열 및 별칭 필터

즉시 입력

❌ 없음

✅ 예

❌ 없음

직접 ~/.aws/credentials 동기화

원자적 & 0600

❌ 토큰 캐시 전용

⚠️ 셸 래퍼

⚠️ 키체인 래퍼

레거시 및 GUI 도구 호환성

100% 즉시 사용 가능

⚠️ 많은 도구에서 실패

⚠️ 래퍼 필요

⚠️ 래퍼 필요

WSL2 -> Windows 브라우저 브리지

자동

❌ 실패 / 수동 복사

⚠️ 부분적

❌ 아니요

EC2 SSM 및 EKS 컨텍스트 전환

내장

❌ 별도 도구

❌ 별도 도구

❌ 아니요

👉 전체 기능 비교 가이드 보기.


✨ 주요 기능

  • 제로 보일러플레이트 검색: ~/.aws/config에 수백 줄을 유지할 필요가 없습니다. SSO 시작 URL을 한 번만 입력하면 모든 권한이 부여된 계정과 역할이 동적으로 로드됩니다.

  • 지능형 역할 우선순위 지정 (MRU): 가장 최근에 사용한 역할(예: QA Admin, Prod Admin)을 자동으로 #1#2에 고정합니다. Enter를 누르면 1초 이내에 로그인됩니다.

  • 🔍 대화형 부분 문자열 검색: 선택 프롬프트에 키워드(prod, qa, admin, gpu, eks)를 입력하면 수십 개의 계정을 즉시 필터링할 수 있습니다.

  • 🤖 네이티브 Model Context Protocol (MCP) 서버: AWS 프로필 전환, 호출자 ID, EC2/EKS 탐색 기능을 LLM 페어 프로그래머(Claude Desktop, Cursor, Antigravity, Gemini)에 노출합니다.

  • 🔒 엔터프라이즈급 보안: 엄격한 POSIX 0600 파일 권한, 원자적 파일 교체(os.replace), 300초 만료 안전 여유 시간을 제공합니다.

  • 🌐 WSL2 원활한 브라우저 브리지: WSL2를 자동으로 감지하고 Windows 호스트 브라우저에서 인증 URL을 직접 엽니다.

  • ☸️ DevOps 가속화: 즉각적인 EC2 SSM 셸 세션과 원클릭 Amazon EKS kubeconfig 컨텍스트 전환을 제공합니다.


📦 설치

옵션 1: 독립 실행형 바이너리 (권장)

최신 사전 컴파일된 바이너리를 GitHub Releases에서 다운로드하세요:

Windows (PowerShell 원라이너)

PowerShell에서 실행하여 바이너리를 자동으로 다운로드하고 PATH를 구성하세요:

irm https://raw.githubusercontent.com/N0mansky/aws-auth/main/install.ps1 | iex

또는 PowerShell을 통한 수동 다운로드:

curl.exe -L https://github.com/N0mansky/aws-auth/releases/latest/download/aws-auth-windows-amd64.exe -o aws-auth.exe

Linux (x86_64)

curl -L https://github.com/N0mansky/aws-auth/releases/latest/download/aws-auth-linux-amd64 -o aws-auth
chmod +x aws-auth && sudo mv aws-auth /usr/local/bin/

macOS (Universal)

curl -L https://github.com/N0mansky/aws-auth/releases/latest/download/aws-auth-macos-universal -o aws-auth
chmod +x aws-auth && sudo mv aws-auth /usr/local/bin/

옵션 2: pip로 설치

pip install git+https://github.com/N0mansky/aws-auth.git

옵션 3: 소스에서 클론 및 설치

git clone https://github.com/N0mansky/aws-auth.git
cd aws-auth

./install.sh                      # Linux / macOS / WSL2
powershell .\install.ps1          # Windows (PowerShell)
.\install.bat                     # Windows (Command Prompt)

🚀 빠른 시작

1. 대화형 로그인

aws-auth
Available account-role combinations (Showing 1-10 of 18):
+-----+------------------------------+-----------------+------------------------------+-------------+
| #   | Account                      | Account ID      | Role                         | Region      |
+-----+------------------------------+-----------------+------------------------------+-------------+
| 1   | ⭐ Production-App (PROD)        | (111222333444)  | AdministratorAccess     | us-east-1   |
| 2   | ⭐ Staging-Web (QA)          | (555666777888)  | AdministratorAccess     | us-east-1   |
| 3   | Analytics-Data                  | (999888777666)  | AdministratorAccess     | us-east-1   |
...
Select number 1-10 (default: 1) (type keyword to filter): [ENTER]

✅ Profile 'production-app-admin' set as default in ~/.aws/credentials.

2. 포털 및 사용자 정의 별칭 구성

aws-auth --configure

~/.aws-auth/config.json에서 환경 레이블과 기본 계정을 사용자 정의하세요:

{
  "sso_start_url": "https://my-company.awsapps.com/start",
  "sso_region": "us-east-1",
  "preferred_accounts": ["Staging-Web", "Production-App"],
  "aliases": {
    "555666777888": "QA",
    "111222333444": "PROD"
  }
}

🤖 AI 에이전트 통합 (Model Context Protocol)

aws-auth는 stdio를 통해 고성능 MCP 서버로 실행됩니다.

Claude Desktop (claude_desktop_config.json) 또는 Cursor에 추가:

{
  "mcpServers": {
    "aws-auth": {
      "command": "aws-auth",
      "args": ["--mcp"]
    }
  }
}

AI 어시스턴트가 aws-auth로 할 수 있는 작업:

  • 활성 AWS 계정, 리전 및 IAM 역할 ARN을 확인합니다 (aws_get_caller_identity).

  • 사람의 개입 없이 활성 AWS 프로필을 전환합니다 (aws_switch_profile).

  • 실행 중인 EC2 인스턴스와 Amazon EKS 클러스터를 검사합니다 (aws_list_ec2_instances, aws_list_eks_clusters).

  • 로컬 Kubernetes 컨텍스트를 업데이트합니다 (aws_update_kubeconfig).

👉 전체 MCP 설정 및 도구 참조 가이드 보기.


🛠️ CLI 명령 참조

# Core Authentication
aws-auth                     # Interactive SSO login & smart role switch
aws-auth --configure         # Interactive SSO portal setup
aws-auth --identity          # Show current STS caller identity
aws-auth --refresh-cache     # Force refresh remote account/role metadata

# Profile Management
aws-auth --list-profiles     # List all stored AWS profiles
aws-auth --switch-profile    # Switch active default profile
aws-auth --set-default NAME  # Set specific profile as default
aws-auth --delete NAME       # Delete profile credentials

# Resource Discovery & DevOps
aws-auth --list-ec2          # List EC2 instances and connect via SSM
aws-auth --list-eks          # List EKS clusters and update kubeconfig

# Scripting & Headless Automation
aws-auth --list-profiles --json
aws-auth --identity --json
eval $(aws-auth --export-env prod-profile)  # Export AWS keys to current shell

# AWS credential_process standard
aws-auth --credential-process my-profile

📚 문서


🤝 기여

기여를 환영합니다! 개발 환경 설정 및 테스트 실행에 대한 자세한 내용은 CONTRIBUTING.md를 확인해 주세요.


📄 라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다.

-
license - not tested
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.

  • MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/N0mansky/aws-auth'

If you have feedback or need assistance with the MCP directory API, please join our Discord server