Aws Claw: AWS KI-Assistent 🤖❤️☁️

Aws Claw ist eine Erweiterung für Visual Studio Code (und Forks wie Google Antigravity, Windsurf usw.), die AWS-Interaktion in Ihr Chat-Erlebnis integriert. Verwenden Sie natürliche Sprache, um AWS-Ressourcen mit Ihren vorhandenen Anmeldeinformationen zu untersuchen und zu bedienen. Die Erweiterung stellt AWS-fähige Tools bereit, die Aktionen direkt in Ihrem Namen ausführen.

💬 Chat-Modi

• Agenten- oder Planungsmodus: Die Erweiterung registriert AWS-Dienst-Tools, die der KI-Assistent basierend auf Ihren Anfragen aufrufen kann. Sie können Fragen stellen, und der Assistent ruft die entsprechenden Tools auf, um Daten abzurufen oder Aktionen auszuführen. Wir empfehlen, für die meisten Anwendungsfälle mit diesem Modus zu beginnen.

• Frage- oder Bearbeitungsmodus: Sie können auch Fragen stellen oder Befehle direkt über das Präfix "@aws" in der Chateingabe erteilen. Der Assistent antwortet mit den angeforderten Informationen oder führt die angegebenen Aktionen aus. Wir empfehlen diesen Modus für schnelle Abfragen oder einfache Aufgaben oder wenn Sie keinen Zugriff auf den Agenten-/Planungsmodus haben.

Related MCP server: AWS MCP Server

🔌 MCP-Unterstützung

• Vscode: Es ist kein Einrichten eines MCP-Servers erforderlich. Aws Claw ist in den Vscode-Chat (Copilot) integriert und es ist keine zusätzliche Einrichtung erforderlich. Starten Sie einfach einen Chat über Ihre AWS-Ressourcen.

• Google Antigravity / Windsurf / Andere: Sie benötigen einen lokalen MCP-Server, um diese Editoren mit Aws Claw zu verbinden. Siehe README_MCP für detaillierte Einrichtungsanweisungen.

🔑 Unterstützte AWS-Dienste

Klicken Sie hier für die vollständige Liste der unterstützten AWS-Dienste und Aktionen.

🤖 Verfügbare Tools

• Session & STS: Verwalten von Profil/Region/Endpunkt, Aktualisieren von Anmeldeinformationen, GetCallerIdentity, Sitzungstoken.

• S3: Auflisten von Buckets/Objekten, Abrufen/Hochladen/Löschen von Objekten.

• SQS & SNS: Auflisten von Warteschlangen/Themen, Senden/Empfangen/Löschen von Nachrichten, Abrufen von Warteschlangen-URLs.

• EC2: Beschreiben von Instanzen, Images, VPCs, Sicherheitsgruppen, Konsolenausgabe.

• Lambda & Step Functions: Aufrufen von Funktionen, Auflisten von Zustandsmaschinen und Ausführungen.

• EMR: Beschreiben von Clustern, Schritten, Studios, Notebook-Ausführungen und Skalierungsrichtlinien.

• CloudWatch Logs: Suchen und Abrufen von Protokollereignissen.

• CloudFormation: Auflisten von Stacks, Beschreiben von Stack-Ressourcen und Ereignissen.

• RDS & RDS Data: Auflisten von DB-Instanzen/Clustern; Ausführen von SQL über die RDS Data API.

• DynamoDB: Auflisten von Tabellen, Beschreiben von Tabellen, Scannen/Abfragen von Elementen.

• IAM & STS: Identitäts- und Anmeldeinformations-Dienstprogramme.

• API Gateway, Glue: Dienstverwaltung und Unterstützung für S3-kompatible Endpunkte.

• Dateioperationen: Arbeiten mit lokalem Arbeitsbereichskontext.

❓ Fragen & Antworten

Authentifizierung

• F: Wie authentifiziert sich Aws Claw bei AWS? A: Es verwendet Ihre vorhandenen, lokal konfigurierten AWS-Anmeldeinformationen (über AWS CLI-Konfiguration, SSO, Umgebungsvariablen usw.) und die AWS SDK-Anbieterkette.

• F: Werden meine AWS-Anmeldeinformationen von der Erweiterung gespeichert? A: Nein, Anmeldeinformationen werden nicht außerhalb des globalen VS Code-Status gespeichert. Sie können zwischengespeicherte Anmeldeinformationen über die Befehlspalette aktualisieren oder löschen.

Berechtigungen

• F: Welche Berechtigungen sind erforderlich? A: Die Erweiterung ruft AWS-APIs unter Verwendung Ihrer Kontoberechtigungen auf. Verwenden Sie IAM-Richtlinien mit den geringsten Rechten und überprüfen Sie das aktive Profil, bevor Sie mutierende Aktionen ausführen.

• F: Kann ich diese Erweiterung mit mehreren AWS-Konten verwenden? A: Ja, Sie können Profile über den AWS-Auswähler in der Statusleiste oder über Befehle in der Befehlspalette wechseln.

Kosten

• F: Sind mit der Nutzung dieser Erweiterung Kosten verbunden? A: Die Erweiterung selbst ist kostenlos, aber AWS-API-Aufrufe können je nach Nutzung und AWS-Preisgestaltung Kosten verursachen.

Sicherheit

• F: Werden meine AWS-Anmeldeinformationen an Copilot oder andere KI-Dienste weitergegeben? A: Nein, Ihre AWS-Anmeldeinformationen werden lokal von der Erweiterung verarbeitet und nicht an externe KI-Dienste gesendet.

Sicherheit

• F: Ist es möglich, dass die Erweiterung unbeabsichtigte Aktionen in meinem AWS-Konto ausführt? A: Die Erweiterung holt vor der Ausführung der folgenden Aktionen immer eine Bestätigung von Ihnen ein:

  • put, post, upload, download, delete, copy, create, update, insert, commit, rollback, send, publish, invoke, start, execute.

  • List, get, describe, search, scan, query Aktionen sind schreibgeschützt und sicher.

• F: Kann ich die ausgeführten AWS-API-Aufrufe sehen? A: Ja, Sie können den Verlauf der AWS-API-Aufrufe im Bereich "Befehlsverlauf" und im Ausgabekanal namens "Aws Claw-Log" sehen. Um den Ausgabekanal zu öffnen, gehen Sie zu Ansicht -> Ausgabe und wählen Sie dann "Aws Claw-Log" aus dem Dropdown-Menü. Um den Bereich "Befehlsverlauf" zu öffnen, klicken Sie auf den Befehl "Aws Claw: Open Command History" in der Befehlspalette. Sie können die API-Aufrufantworten sehen, wenn Sie den Verlauf in eine Datei exportieren.

📺 Screenshots

⚙️ Voraussetzungen

• Lokal konfigurierte AWS-Anmeldeinformationen (über AWS CLI-Konfiguration, SSO, Umgebungsvariablen oder andere unterstützte Methoden).

🏁 Schnellstart

1. AWS-Anmeldeinformationen: Stellen Sie sicher, dass Sie AWS-Anmeldeinformationen lokal konfiguriert haben. Sie können die AWS CLI verwenden, um Profile oder SSO einzurichten.

2. Konnektivität testen: Klicken Sie in der Statusleiste auf "🔌Aws" und führen Sie "Aws Claw: Test AWS Connection" aus, um den AWS-Zugriff zu überprüfen. Sie können bei Bedarf das Standardprofil, die Region und den Endpunkt (für Localstack) festlegen.

3. Google Antigravity / Windsurf / Andere: Sie benötigen einen lokalen MCP-Server, um diese Editoren mit Aws Claw zu verbinden. Siehe README_MCP für detaillierte Einrichtungsanweisungen.

4. Chat öffnen: Öffnen Sie den Chat (verwenden Sie @aws im Frage- oder Bearbeitungsmodus) und stellen Sie eine Frage, zum Beispiel:

   • List my S3 buckets

   • Tail the latest CloudWatch log events for /aws/lambda/my-fn

   • Describe EC2 instances in us-west-2

   • Publish a message to my SNS topic

5. Ergebnisse überprüfen: Der Assistent ruft das entsprechende Tool auf, streamt die Ergebnisse und schlägt Folgeaktionen vor.

🧠 Fähigkeiten installieren

Aws Claw wird mit einer Reihe von Agentenfähigkeiten geliefert, die GitHub Copilot beibringen, wie man mit AWS-Diensten arbeitet. Installieren Sie sie mit:

npx skills add necatiarslan/awsclaw

Sobald die Fähigkeiten installiert sind, stehen sie in Ihren Agentensitzungen zur Verfügung und bieten dem Assistenten fundiertes Wissen über AWS-Dienste, bewährte Verfahren und Anleitungen zur Tool-Nutzung für alle unterstützten Dienste.

👮 Authentifizierung & Sicherheit

• Anmeldeinformationen: Werden über die AWS SDK-Anbieterkette aufgelöst. Das ausgewählte Profil wird im globalen VS Code-Status gespeichert und sitzungsübergreifend erneut angewendet.

• Datenschutz: Es werden keine Anmeldeinformationen außerhalb des globalen VS Code-Status gespeichert. Sie können zwischengespeicherte Anmeldeinformationen über die Befehlspalette aktualisieren oder löschen.

• Berechtigungen: Der Assistent ruft AWS-APIs unter Verwendung Ihrer Kontoberechtigungen auf. Verwenden Sie IAM-Richtlinien mit den geringsten Rechten und überprüfen Sie das aktive Profil, bevor Sie mutierende Aktionen ausführen.

📋 TODO

• Hinzufügen weiterer AWS-Dienste und Aktionen.

  • 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

• Verbesserung des Verständnisses natürlicher Sprache für AWS-spezifische Abfragen.

• Einstellungsbereich wie bei Copilot für eine bessere Benutzererfahrung.

💖 Links

• Probleme & Funktionsanfragen: https://github.com/necatiarslan/awsclaw/issues

• Sponsor: https://github.com/sponsors/necatiarslan

• Lizenz: MIT