Aws Claw: ИИ-ассистент для AWS 🤖❤️☁️

Aws Claw — это расширение для Visual Studio Code (и его форков, включая Google Antigravity, Windsurf и др.), которое интегрирует взаимодействие с AWS в ваш чат. Используйте естественный язык для проверки и управления ресурсами AWS с помощью ваших существующих учетных данных. Расширение предоставляет инструменты, учитывающие специфику AWS, которые выполняют действия непосредственно от вашего имени.

💬 Режимы чата

• Режим агента или планирования (Agent Or Plan Mode): расширение регистрирует инструменты служб AWS, которые ИИ-ассистент может вызывать на основе ваших запросов. Вы можете задавать вопросы, а ассистент будет вызывать соответствующие инструменты для получения данных или выполнения действий. Мы рекомендуем начинать с этого режима для большинства сценариев использования.

• Режим запроса или редактирования (Ask Or Edit Mode): вы также можете задавать вопросы или отдавать команды напрямую, используя префикс "@aws" в поле ввода чата. Ассистент ответит на запрошенную информацию или выполнит указанные действия. Мы рекомендуем этот режим для быстрых запросов, простых задач или если у вас нет доступа к режиму агента/планирования.

Related MCP server: AWS MCP Server

🔌 Поддержка MCP

• Vscode: Нет необходимости настраивать MCP-сервер. Aws Claw встроен в чат Vscode (Copilot), дополнительная настройка не требуется. Просто начните чат о ваших ресурсах AWS.

• Google Antigravity / Windsurf / Другие: Вам потребуется локальный MCP-сервер для подключения этих редакторов к Aws Claw. Подробные инструкции по настройке см. в README_MCP.

🔑 Поддерживаемые службы AWS

Нажмите здесь для получения полного списка поддерживаемых служб и действий AWS.

🤖 Доступные инструменты

• Сеанс и STS: управление профилем/регионом/эндпоинтом, обновление учетных данных, GetCallerIdentity, токены сеанса.

• S3: список бакетов/объектов, получение/отправка/удаление объектов.

• SQS и SNS: список очередей/топиков, отправка/получение/удаление сообщений, получение URL-адресов очередей.

• EC2: описание инстансов, образов, VPC, групп безопасности, вывод консоли.

• Lambda и Step Functions: вызов функций, список конечных автоматов и выполнений.

• EMR: описание кластеров, шагов, студий, выполнений блокнотов и политик масштабирования.

• CloudWatch Logs: поиск и извлечение событий журналов.

• CloudFormation: список стеков, описание ресурсов и событий стека.

• RDS и RDS Data: список экземпляров/кластеров БД; выполнение SQL через API RDS Data.

• DynamoDB: список таблиц, описание таблиц, сканирование/запрос элементов.

• IAM и STS: утилиты идентификации и учетных данных.

• API Gateway, Glue: управление службами и поддержка эндпоинтов, совместимых с S3.

• Операции с файлами: работа с контекстом локальной рабочей области.

❓ Вопросы и ответы

Аутентификация

• В: Как Aws Claw проходит аутентификацию в AWS? О: Он использует ваши существующие учетные данные AWS, настроенные локально (через конфигурацию AWS CLI, SSO, переменные окружения и т. д.), и цепочку провайдеров AWS SDK.

• В: Хранятся ли мои учетные данные AWS расширением? О: Нет, учетные данные не сохраняются вне глобального состояния VS Code. Вы можете обновить или очистить кэшированные учетные данные из палитры команд.

Разрешения

• В: Какие разрешения требуются? О: Расширение вызывает API AWS, используя разрешения вашей учетной записи. Используйте политики IAM с минимальными привилегиями и проверяйте активный профиль перед выполнением изменяющих действий.

• В: Могу ли я использовать это расширение с несколькими учетными записями AWS? О: Да, вы можете переключать профили с помощью селектора AWS в строке состояния или команд в палитре команд.

Стоимость

• В: Есть ли какая-либо стоимость, связанная с использованием этого расширения? О: Само расширение бесплатно, но вызовы API AWS могут повлечь за собой расходы в зависимости от вашего использования и тарифов AWS.

Безопасность

• В: Передаются ли мои учетные данные AWS в Copilot или другие ИИ-сервисы? О: Нет, ваши учетные данные AWS обрабатываются локально расширением и не отправляются никаким внешним ИИ-сервисам.

Безопасность (Safety)

• В: Возможно ли, что расширение выполнит непреднамеренные действия в моей учетной записи AWS? О: Расширение всегда запрашивает у вас подтверждение для действий, перечисленных ниже, перед их выполнением:

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

  • Действия List, get, describe, search, scan, query являются только для чтения и безопасны.

• В: Могу ли я видеть выполняемые вызовы API AWS? О: Да, вы можете увидеть историю вызовов API AWS на панели "История команд" и в канале вывода с названием "Aws Claw-Log". Чтобы открыть канал вывода, перейдите в View -> Output, затем выберите "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 / Другие: Вам потребуется локальный MCP-сервер для подключения этих редакторов к Aws Claw. Подробные инструкции по настройке см. в README_MCP.

4. Открыть чат: Откройте чат (используйте @aws в режиме запроса или редактирования) и задайте вопрос, например:

   • Перечисли мои бакеты S3

   • Выведи последние события журнала CloudWatch для /aws/lambda/my-fn

   • Опиши инстансы EC2 в us-west-2

   • Опубликуй сообщение в мой топик SNS

5. Просмотр результатов: Ассистент вызовет соответствующий инструмент, передаст результаты и предложит последующие действия.

🧠 Установка навыков

Aws Claw поставляется с набором навыков агента, которые обучают GitHub Copilot работе со службами AWS. Установите их с помощью:

npx skills add necatiarslan/awsclaw

После установки навыки становятся доступными в ваших сеансах агента и предоставляют ассистенту глубокие знания о службах AWS, передовых методах и руководствах по использованию инструментов для всех поддерживаемых служб.

👮 Аутентификация и безопасность

• Учетные данные: Разрешаются через цепочку провайдеров AWS SDK. Выбранный профиль сохраняется в глобальном состоянии VS Code и повторно применяется в сеансах.

• Конфиденциальность: Никакие учетные данные не сохраняются вне глобального состояния VS Code. Вы можете обновить или очистить кэшированные учетные данные из палитры команд.

• Разрешения: Ассистент вызывает API AWS, используя разрешения вашей учетной записи. Используйте политики IAM с минимальными привилегиями и проверяйте активный профиль перед выполнением изменяющих действий.

📋 ПЛАН (TODO)

• Добавить больше служб и действий AWS.

  • Уровень 1: ECS, EKS, Secrets Manager, Systems Manager, ECR, метрики и оповещения CloudWatch

  • Уровень 2: ElastiCache, EventBridge, Kinesis, Route53, EFS, Cloud Trail, KMS, ELB

  • Уровень 3: X-Ray, Athena, Redshift

• Улучшить понимание естественного языка для запросов, специфичных для AWS.

• Панель настроек, подобная Copilot, для лучшего пользовательского опыта.

💖 Ссылки

• Проблемы и запросы функций: https://github.com/necatiarslan/awsclaw/issues

• Спонсорство: https://github.com/sponsors/necatiarslan

• Лицензия: MIT