Skip to main content
Glama

⚡ AWS-Auth

Schneller, intelligenter AWS-SSO-Authentifizierungs- und Model Context Protocol (MCP)-Server

CI Release License: MIT Python Version MCP Ready

Schluss mit AWS-SSO-Anmeldefrust. Kein Konfigurations-Boilerplate, intelligente Rollenpriorisierung, atomares Credential-Caching und native KI-Pair-Programming-Integration.

SchnellstartWarum aws-auth?KI-/MCP-IntegrationFunktionenDokumentation


  ┌───────────────────────┐       ┌────────────────────────┐       ┌───────────────────────┐
  │  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)│
                                  └────────────────────────┘       └───────────────────────┘

💡 Warum aws-auth vs. Alternativen?

Funktion

aws-auth

Offizielles aws sso login

granted / assume

aws-vault

Zero-Config-Kontenermittlung

Automatisch

❌ Erfordert manuelles ~/.aws/config

⚠️ Teilweise

❌ Manuell

Model Context Protocol (MCP)

Nativ integriert

❌ Keine

❌ Keine

❌ Keine

1-Sekunden-MRU / angeheftete Anmeldungen

Intelligente Priorisierung

❌ Keine

⚠️ Verlaufsabfrage

❌ Keine

Echtzeit-Teilstring- & Alias-Filter

Sofort beim Tippen

❌ Keine

✅ Ja

❌ Keine

Direkte ~/.aws/credentials-Synchronisierung

Atomar & 0600

❌ Nur Token-Cache

⚠️ Shell-Wrapper

⚠️ Keychain-Wrapper

Kompatibilität mit Legacy- & GUI-Tools

100 % sofort einsatzbereit

⚠️ Viele Tools scheitern

⚠️ Erfordert Wrapper

⚠️ Erfordert Wrapper

WSL2-zu-Windows-Browser-Brücke

Automatisch

❌ Scheitert / manuelles Kopieren

⚠️ Teilweise

❌ Nein

EC2-SSM- & EKS-Kontextwechsel

Integriert

❌ Separate Tools

❌ Separate Tools

❌ Nein

👉 Lies den vollständigen Feature-Vergleichsleitfaden.


✨ Hauptfunktionen

  • Zero-Boilerplate-Erkennung: Keine Notwendigkeit, hunderte Zeilen in ~/.aws/config zu pflegen. Gib einmal deine SSO-Start-URL ein, und alle autorisierten Konten und Rollen werden dynamisch geladen.

  • Intelligente Rollenpriorisierung (MRU): Heftet deine zuletzt verwendeten Rollen (z. B. QA Admin, Prod Admin) automatisch auf #1 und #2. Mit Enter meldest du dich innerhalb von 1 Sekunde an.

  • 🔍 Interaktive Teilstring-Suche: Gib ein beliebiges Stichwort (prod, qa, admin, gpu, eks) in der Auswahlaufforderung ein, um Dutzende Konten sofort zu filtern.

  • 🤖 Nativer Model Context Protocol (MCP)-Server: Stelle AWS-Profilwechsel, Aufruferidentität und EC2/EKS-Erkundung LLM-Pair-Programmierern (Claude Desktop, Cursor, Antigravity, Gemini) bereit.

  • 🔒 Sicherheit auf Enterprise-Niveau: Strikte POSIX-Dateiberechtigungen 0600, atomarer Dateiaustausch (os.replace) und 300-Sekunden-Sicherheitsmargen für den Ablauf.

  • 🌐 Nahtlose WSL2-Browser-Brücke: Erkennt WSL2 automatisch und öffnet Autorisierungs-URLs direkt im Browser deines Windows-Hosts.

  • ☸️ DevOps-Beschleunigung: Sofortige EC2-SSM-Shell-Sitzungen und 1-Klick-Kontextwechsel für Amazon-EKS-kubeconfig.


📦 Installation

Option 1: Eigenständige Binärdatei (Empfohlen)

Lade die neueste vorkompilierte Binärdatei von den GitHub-Releases herunter:

Windows (PowerShell-Einzeiler)

Führe in PowerShell aus, um die Binärdatei automatisch herunterzuladen und deinen PATH zu konfigurieren:

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

Oder manueller Download über 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/

Option 2: Installation über pip

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

Option 3: Klonen und aus dem Quellcode installieren

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)

🚀 Schnellstart

1. Interaktive Anmeldung

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. Portal und benutzerdefinierte Aliase konfigurieren

aws-auth --configure

Passe Umgebungsbezeichnungen und bevorzugte Konten in ~/.aws-auth/config.json an:

{
  "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"
  }
}

🤖 KI-Agenten-Integration (Model Context Protocol)

aws-auth läuft als hochperformanter MCP-Server über stdio.

Zu Claude Desktop (claude_desktop_config.json) oder Cursor hinzufügen:

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

Was KI-Assistenten mit aws-auth tun können:

  • Aktives AWS-Konto, Region und IAM-Rollen-ARN prüfen (aws_get_caller_identity).

  • Aktives AWS-Profil ohne menschliches Eingreifen wechseln (aws_switch_profile).

  • Laufende EC2-Instanzen und Amazon-EKS-Cluster untersuchen (aws_list_ec2_instances, aws_list_eks_clusters).

  • Lokalen Kubernetes-Kontext aktualisieren (aws_update_kubeconfig).

👉 Lies den vollständigen MCP-Setup- und Tool-Referenzleitfaden.


🛠️ CLI-Befehlsreferenz

# 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

📚 Dokumentation


🤝 Mitwirken

Beiträge sind willkommen! Wirf einen Blick in CONTRIBUTING.md für Details zum Einrichten einer Entwicklungsumgebung und zum Ausführen von Tests.


📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

-
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