Skip to main content
Glama
deenesjakoruzh
N0mansky

AWS-Auth

by N0mansky
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

⚡ 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 ライセンス の下でライセンスされています。

This server cannot be installed

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

How are these scores calculated?

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

  • DataDoe MCP

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

  • microservices.sh

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

  • agentcentral

    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