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チャット（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ポリシーを使用し、変更を伴うアクションを実行する前にアクティブなプロファイルを確認してください。

📋 TODO

• より多くの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