localstack-mcp-server — MCP-сервер для Claude Code: настройка
Подключает эмулятор облачных сервисов LocalStack к ассистенту для локального развёртывания инфраструктуры и отладки без реального облака.
claude mcp add --env LOCALSTACK_AUTH_TOKEN=<LOCALSTACK_AUTH_TOKEN> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> --env AWS_DEFAULT_REGION=<AWS_DEFAULT_REGION> --transport stdio localstack-mcp-server -- npx -y @localstack/localstack-mcp-serverЧто делает localstack-mcp-server
MCP-сервер связывает ассистента с локальным окружением LocalStack. Через инструмент localstack-management модель может запускать и останавливать контейнеры эмуляторов AWS или Azure, а также опрашивать их текущий статус.
Агент умеет применять конфигурации Terraform, CDK и SAM без обращения к настоящим облачным провайдерам. При возникновении ошибок доступа модель разбирает журнал событий и формирует нужные правила IAM. Для проверки надёжности приложений доступна эмуляция сетевых сбоев и задержек.
Каждый инструмент этого сервера требует переменную LOCALSTACK_AUTH_TOKEN. Без установленных в системе утилит tflocal, cdklocal или samlocal применить инфраструктурный код локально не получится.
Какие задачи решает
- разворачивать конфигурации Terraform, CDK и SAM в локальном эмуляторе
- находить ошибки прав доступа в логах и генерировать правила IAM
- тестировать устойчивость сервисов через добавление задержек в запросы
- сохранять и восстанавливать снимки состояния служб через Cloud Pods
Примеры запросов агенту
- Запусти LocalStack, разверни проект из каталога
./infraчерез Terraform и перечисли поднятые ресурсы. - Изучи логи упавшей функции Lambda, определи ошибки разрешений и подготовь файл политики IAM.
- Добавь задержку 500 мс в DynamoDB и проверь работу логики повторных запросов.
Как установить localstack-mcp-server
Командой платформы
claude mcp add --env LOCALSTACK_AUTH_TOKEN=<LOCALSTACK_AUTH_TOKEN> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> --env AWS_DEFAULT_REGION=<AWS_DEFAULT_REGION> --transport stdio localstack-mcp-server -- npx -y @localstack/localstack-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
codex mcp add localstack-mcp-server --env LOCALSTACK_AUTH_TOKEN=<LOCALSTACK_AUTH_TOKEN> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> --env AWS_DEFAULT_REGION=<AWS_DEFAULT_REGION> -- npx -y @localstack/localstack-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"localstack-mcp-server": {
"command": "npx",
"args": [
"-y",
"@localstack/localstack-mcp-server"
],
"env": {
"LOCALSTACK_AUTH_TOKEN": "<LOCALSTACK_AUTH_TOKEN>",
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
"AWS_SESSION_TOKEN": "<AWS_SESSION_TOKEN>",
"AWS_DEFAULT_REGION": "<AWS_DEFAULT_REGION>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"localstack-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@localstack/localstack-mcp-server"
],
"env": {
"LOCALSTACK_AUTH_TOKEN": "<LOCALSTACK_AUTH_TOKEN>",
"AWS_ACCESS_KEY_ID": "<AWS_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<AWS_SECRET_ACCESS_KEY>",
"AWS_SESSION_TOKEN": "<AWS_SESSION_TOKEN>",
"AWS_DEFAULT_REGION": "<AWS_DEFAULT_REGION>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e LOCALSTACK_AUTH_TOKEN=<LOCALSTACK_AUTH_TOKEN> -e AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> -e AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> -e AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> -e AWS_DEFAULT_REGION=<AWS_DEFAULT_REGION> localstack-mcp-server npx -y @localstack/localstack-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о localstack-mcp-server
Как установить localstack-mcp-server в Claude Code?
Выполните команду `claude mcp add --env LOCALSTACK_AUTH_TOKEN=<LOCALSTACK_AUTH_TOKEN> --env AWS_ACCESS_KEY_ID=<AWS_ACCESS_KEY_ID> --env AWS_SECRET_ACCESS_KEY=<AWS_SECRET_ACCESS_KEY> --env AWS_SESSION_TOKEN=<AWS_SESSION_TOKEN> --env AWS_DEFAULT_REGION=<AWS_DEFAULT_REGION> --transport stdio localstack-mcp-server -- npx -y @localstack/localstack-mcp-server`. Замените значения в угловых скобках своими учётными данными.
Что делает localstack-mcp-server?
Сервер даёт ИИ-агенту доступ к управлению локальными облачными сервисами LocalStack, развёртыванию инфраструктурного кода и диагностике сбоев.
Какие системные зависимости нужны для деплоя инфраструктуры?
Для работы инструмента localstack-deployer на компьютере должны быть предварительно установлены утилиты tflocal, cdklocal или samlocal.
