MCP Server Aws Sso

🚀 モデルコンテキストプロトコル（MCP）サーバー

このプロジェクトは、AIシステムを安全かつコンテキストに沿って外部ツールやデータソースに接続するための開放標準であるモデルコンテキストプロトコル（MCP）を実装したサーバーです。AWS SSOを使用して、AIアシスタントをAWSサービスに安全に接続します。

🚀 クイックスタート

前提条件

• Node.js (>=18.x)：ダウンロード
• SSO設定済みのAWSアカウント：SSOが有効なAWSアカウントと適切な権限が必要です。
• AWS CLI v2：ローカルのSSO認証設定に使用します。

ステップ1：AWS SSOの設定

AWSアカウントでAWS SSOを設定します。

1. AWS IAM Identity Center（SSOの後継）を有効にします。
2. アイデンティティソース（AWS SSOディレクトリ、Active Directory、または外部IdP）を設定します。
3. 権限セットを設定し、ユーザーをAWSアカウントに割り当てます。
4. AWS SSOの開始URLを記録します。これは後で設定に使用します。

ステップ2：認証情報の設定

方法A：MCP設定ファイル（推奨）

~/.mcp/configs.json を作成または編集します。

{
    "aws-sso": {
        "environments": {
            "DEBUG": "true",
            "AWS_REGION": "us-east-1",
            "AWS_SSO_START_URL": "https://your-sso-portal.awsapps.com/start"
        }
    }
}

• AWS_REGION：主なAWSリージョン（例：us-east-1）
• AWS_SSO_START_URL：AWS SSOポータルのURL

注意：下位互換性のため、サーバーは完全なパッケージ名（@aashari/mcp-server-aws-sso）または環境変数（AWS_SSO_START_URL と AWS_REGION）を使用した設定も認識します。

ステップ3：インストールと使用

npx を使用したクイックスタート

# 必要な環境変数を設定します（実際の値に置き換えてください）
export AWS_SSO_START_URL=https://your-sso-portal.awsapps.com/start
export AWS_REGION=us-east-1

# AWS SSOにログインします
npx -y @aashari/mcp-server-aws-sso login

# 利用可能なアカウントとロールを一覧表示します
npx -y @aashari/mcp-server-aws-sso ls-accounts

# SSO認証情報を使用してAWS CLIコマンドを実行します
npx -y @aashari/mcp-server-aws-sso exec-cmd \
  --account-id 123456789012 \
  --role-name ReadOnly \
  --command "aws s3 ls"

グローバルインストール

npm install -g @aashari/mcp-server-aws-sso

その後、以下のコマンドを直接実行できます。

mcp-aws-sso login
mcp-aws-sso ls-accounts
mcp-aws-sso exec-cmd --account-id 123456789012 --role-name ReadOnly --command "aws s3 ls"

コマンドラインインターフェイス（CLI）

CLIはハイフン付きのコマンド（例：login）とオプション（例：--account-id）を使用します。

ヘルプの表示

すべての利用可能なコマンドのフラグと使い方を表示するには、--help を使用します。

mcp-aws-sso --help

特定のコマンドの詳細なヘルプを表示するには、以下のようにします。

mcp-aws-sso login --help
mcp-aws-sso ls-accounts --help
mcp-aws-sso exec-cmd --help

✨ 主な機能

• シームレスなAWS SSO統合：安全なシングルサインオンを介してAWSに接続し、AIインタラクションでの長期認証情報の管理や暴露を避けます。
• 安全な認証情報管理：AWS SSOで取得した一時的な認証情報を使用し、AWSのセキュリティベストプラクティスに従い、自動的に認証情報を更新します。
• 複数アカウントへのアクセス：SSOプロファイルで設定したすべてのAWSアカウントとロールを簡単に見つけて使用できます。
• 完全なAWS CLIサポート：AIアシスタントから直接、適切な認証と認証情報管理を伴って任意のAWS CLIコマンドを実行できます。
• 自動認証フロー：ブラウザの起動とトークンのポーリングを自動で処理し、認証プロセスをシンプルかつ直感的にします。

📄 ライセンス

ISC License