localstack

localstack

giovanemartinsMIT
1 звёзд
MCP-сервер для работы AI-ассистентов с локальными AWS-сервисами через LocalStack. Вы даёте ассистенту команду — он выполняет операции с S3, SQS, Lambda и другими сервисами на вашем локальном экземпляре LocalStack. Никакого реального AWS не нужно. Подходит для разработки, тестирования и отладки приложений, использующих облачную инфраструктуру. Все запросы направляются к LocalStack по адресу http://localhost:4566. Вы можете изменить эндпоинт или регион через переменные окружения. Сервер поддерживает стандартный протокол MCP и совместим с любыми MCP-клиентами. Сервер автоматически регистрирует инструменты для каждого AWS-сервиса, доступного в LocalStack. Вы получаете единый интерфейс для управления бакетами, очередями, функциями и другими ресурсами.
Ai-mlCloud-devopsAws
Открыть на GitHub

Установка

npx -y @giovane.martins/localstack

Характеристики

Общее

  • СтатусСообщество
  • Разработчикgiovanemartins
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Управление бакетами S3: создание, удаление, просмотр списка объектов
  • Загрузка и скачивание файлов в S3
  • Отправка, получение и удаление сообщений из очередей SQS
  • Вызов Lambda-функций с кастомными событиями и просмотр результатов
  • Публикация сообщений в темы SNS и управление подписками
  • Создание и запросы к таблицам DynamoDB
  • Получение списка активных сервисов LocalStack
  • Настройка учётных данных через переменные окружения

Как подключить

  • 1. Установите сервер глобально через npm:
    npm install -g @giovane.martins/localstack
    Или запускайте без установки через npx:
    npx @giovane.martins/localstack
  • 2. Добавьте конфигурацию в ваш MCP-клиент. Например, для Claude Desktop отредактируйте файл claude_desktop_config.json:
    {
    "mcpServers": {
    "localstack": {
    "command": "npx",
    "args": ["-y", "@giovane.martins/localstack"],
    "env": {
    "LOCALSTACK_ENDPOINT": "http://localhost:4566",
    "AWS_REGION": "us-east-1",
    "AWS_ACCESS_KEY_ID": "test",
    "AWS_SECRET_ACCESS_KEY": "test"
    }
    }
    }
    }
  • 3. Перезапустите клиент.

Убедитесь, что LocalStack запущен (Docker). По умолчанию сервер подключается к http://localhost:4566. При необходимости измените переменные окружения в конфигурации. Для реальных проектов можно указать свои эндпоинты LocalStack.

После перезапуска клиента вы увидите инструменты LocalStack в списке доступных. Попробуйте выполнить простой запрос.

Примеры запросов

  • «Создай бакет S3 с именем my-test-bucket и загрузи в него файл example.txt»
  • «Отправь тестовое сообщение в очередь SQS с именем my-queue»
  • «Вызови Lambda-функцию my-function с событием: {"key": "value"}»
  • «Покажи список всех бакетов S3 в LocalStack»
  • «Создай таблицу DynamoDB с именем Users и ключом id»
  • «Опубликуй сообщение «Hello» в тему SNS с именем news-topic»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимые клиенты: любые MCP-клиенты (Claude Desktop, IDE-плагины и др.)
  • Требования: Node.js 20+, Docker (для LocalStack)
  • Пакет опубликован в npm и MCP Registry

Поделиться