Каталог MCP
localstack/localstack-mcp-server

localstack/localstack-mcp-server

MCP-сервер для управления LocalStack — эмулятором облака. Разворачивайте стек (Terraform, CDK, SAM), анализируйте логи и инжектируйте сбои. Помогает разработчикам и DevOps быстрее отлаживать облачн...

README

14 инструментов

Версии

Установить сервер

LocalStack MCP Server

Let an AI agent manage and interact with LocalStack on your machine.

[!IMPORTANT] The LocalStack MCP server is currently available as an experimental public preview. For questions, issues or feedback, please utilize the LocalStack Community slack or submit a GitHub Issue

LocalStack emulates the cloud on your local machine so software teams and AI agents can validate security, quality, and reliability faster and more safely than the cloud allows. This Model Context Protocol (MCP) server lets any MCP client (Cursor, Claude, VS Code, and more) start LocalStack, deploy infrastructure, and debug your local cloud in natural language.

Quick start

Set up the server in your MCP client with the interactive wizard:

npx -y @localstack/localstack-mcp-server init

The wizard detects your installed clients, asks how you want to run the server, and writes the configuration for you. You need a LocalStack Auth Token; the wizard reads LOCALSTACK_AUTH_TOKEN from your environment or asks for it. For the full options, prerequisites, and manual setup, see Installation.

Инструменты были проиндексированы: 04.09.2026

localstack-app-inspector

Запрашивает и управляет трейсами, спанами и событиями App Inspector для просмотра развёрнутых приложений LocalStack.

LocalStack App Inspector

Параметры

account_idstring
Filter traces or spans by LocalStack AWS account ID.
actionenumобязательный
The App Inspector action to perform. Typical debugging flow: get-status, set-status to enabled if needed, run AWS workload, list-traces, list-spans for a trace, then list-events or list-iam-events for a span.
arnstring
Filter traces or spans by resource ARN. This value is not sent to analytics.
end_time_unix_nanointeger
Filter traces or spans by end timestamp in Unix nanoseconds.
event_idstring
Event ID. Required for get-event.
event_namestring
Filter events by event name.
event_typestring
Filter events by event type, e.g. iam.policy_evaluation.
limitinteger
Maximum number of results to return (1-1000)
operation_namestring
Filter by operation name (e.g., 'CreateBucket')
pagination_tokenstring
Pagination cursor from a previous response
parent_span_idstring
Filter traces or spans by parent span ID.
regionstring
Filter by AWS region (e.g., 'us-east-1')
resource_namestring
Filter by resource name
service_namestring
Filter traces or spans by AWS service name, e.g. lambda, s3, sqs.
span_idstring
Span ID. Required for get-span, list-events, get-event, and list-iam-events. For list-events/list-iam-events, use '*' to query across all spans.
span_idsstring[]
Span IDs to delete for delete-spans. Omit to delete all spans in the trace scope.
start_time_unix_nanointeger
Filter traces or spans by start timestamp in Unix nanoseconds.
statusenum
Status to set. Required for set-status. Use enabled before running a workload you want to inspect.
status_codeinteger
Filter traces or spans by status code.
trace_idstring
Trace ID. Required for get-trace, list-spans, get-span, delete-spans, list-events, get-event, and list-iam-events. For list-spans/list-events/list-iam-events, use '*' to query across all traces.
trace_idsstring[]
Trace IDs to delete for delete-traces. Omit to delete all traces.
versioninteger
Filter traces or spans by App Inspector schema version.

localstack-aws-client

Выполняет команду AWS CLI в работающем контейнере LocalStack с помощью обёртки 'awslocal'.

LocalStack AWS Client

Параметры

commandstringобязательный
The AWS CLI command to execute (e.g., 's3 ls', 'dynamodb list-tables'). Do not include 'awslocal' or 'aws'.

localstack-aws-replicator

Реплицирует внешние ресурсы AWS в работающий экземпляр LocalStack с помощью HTTP API AWS Replicator.

LocalStack AWS Replicator

Параметры

actionenumобязательный
The AWS Replicator action to perform: start a job, check job status, list jobs, or list supported resource types.
job_idstring
Replication job id. Required for the status action.
replication_typeenum
Replication job type. Use SINGLE_RESOURCE for one resource, or BATCH for supported batch jobs such as SSM parameters under a path prefix.
resource_arnstring
Full ARN of the resource to replicate. Only supported for SINGLE_RESOURCE jobs and mutually exclusive with resource_type/resource_identifier.
resource_identifierstring
CloudControl identifier for the resource to replicate, such as a VPC ID (vpc-...), SSM parameter name, IAM role name, or ECR repository name. Required when using resource_type and mutually exclusive with resource_arn. For BATCH SSM parameter replication, this must be a path prefix such as /dev/.
resource_typestring
CloudFormation resource type to replicate, e.g. AWS::EC2::VPC or AWS::SSM::Parameter. Use this with resource_identifier, or provide resource_arn instead.
target_account_idstring
Optional LocalStack target AWS account id override. LocalStack defaults to account 000000000000, so this is only needed when replicating into a non-default account namespace.
target_region_namestring
Optional LocalStack target AWS region override. Defaults to the source region.

localstack-chaos-injector

Внедряет, управляет и очищает хаотические сбои и сетевые эффекты в LocalStack для тестирования устойчивости системы.

LocalStack Chaos Injector

Параметры

actionenumобязательный
The specific chaos engineering action to perform.
latency_msinteger
Network latency in milliseconds. Required for the 'inject-latency' action.
rulesobject[]
An array of fault rules. Required for 'inject-faults', 'add-fault-rule', and 'remove-fault-rule' actions.

localstack-cloud-pods

Управляет удаленными LocalStack Cloud Pods со следующими действиями: сохранить, загрузить, удалить

LocalStack Cloud Pods

Параметры

actionenumобязательный
The Cloud Pods action to perform.
pod_namestring
The name of the Cloud Pod. This is required for 'save', 'load', and 'delete' actions.

localstack-deployer

Развёртывает или уничтожает инфраструктуру AWS на LocalStack с помощью CDK, Terraform или SAM.

LocalStack Deployer

Параметры

actionenumобязательный
The action to perform: 'deploy'/'destroy' for CDK/Terraform, or 'create-stack'/'delete-stack' for CloudFormation.
directorystring
The required path to the project directory containing your infrastructure-as-code files.
projectTypeenum
The type of project. 'auto' (default) infers from files. Specify 'cdk', 'terraform', 'cloudformation', or 'sam' to override.
resolveS3boolean
For SAM deployments, whether to use --resolve-s3 when no s3Bucket is provided.
s3Bucketstring
S3 bucket name used by SAM deployments. If omitted, SAM can use --resolve-s3.
saveParamsboolean
For SAM deployments, whether to persist resolved parameters to samconfig.toml using --save-params.
stackNamestring
The stack name used by CloudFormation and SAM. Required for 'create-stack'/'delete-stack' actions, and optional for SAM deploy/destroy (defaults can be inferred).
templatePathstring
The local template file path used by CloudFormation and SAM. Required for 'create-stack' if not discoverable from 'directory', and optional for SAM as a template override.
variablesobject
Key-value pairs for parameterization. Used for Terraform variables (-var) or CDK context (-c).

localstack-docsтолько чтениеидемпотентный

Поищи в документации LocalStack руководства, ссылки на API и детали конфигурации.

Поиск по документации LocalStack

Параметры

limitinteger
Maximum number of results to return.
querystringобязательный
The search query.

localstack-ephemeral-instances

Управление облачными LocalStack Ephemeral Instances: создание, вывод списка, получение логов и удаление.

Эфемерные инстансы LocalStack

Параметры

actionenumобязательный
The Ephemeral Instances action to perform.
cloudPodstring
Optional Cloud Pod name to initialize state for create action. This is passed as CLOUD_POD_NAME.
envVarsobject
Additional environment variables to pass to the ephemeral instance (create action only).
extensionstring
Optional extension package to preload for create action. This is passed as EXTENSION_AUTO_INSTALL.
lifetimeinteger
Lifetime in minutes for create action. Defaults to the platform default when omitted.
namestring
Instance name. Required for create, logs, and delete actions.

localstack-extensions

Устанавливает, удаляет, выводит список и находит расширения LocalStack из маркетплейса.

LocalStack Extensions

Параметры

actionenumобязательный
list = installed extensions; install = install an extension; uninstall = remove an extension; available = browse the marketplace/extensions library
namestring
Extension package name (e.g. 'localstack-extension-typedb' or 'localstack-extension-typedb==1.0.0'). Required for install and uninstall actions.
sourcestring
Git URL to install from (e.g. 'git+https://github.com/org/repo.git'). Use this instead of name when installing from a repository.

localstack-iam-policy-analyzer

Настраивает принудительное применение IAM в LocalStack и анализирует логи, чтобы автоматически генерировать недостающие IAM-политики.

LocalStack IAM Policy Analyzer

Параметры

actionenumобязательный
The action to perform: 'set-mode' to configure enforcement, 'analyze-policies' to generate a policy from logs, or 'get-status' to check the current mode.
modeenum
The enforcement mode to set. This is required only when the action is 'set-mode'.

localstack-logs-analysisтолько чтениеидемпотентный

Анализатор логов LocalStack, который помогает разработчикам быстро диагностировать проблемы и разбираться в их взаимодействиях с LocalStack

Анализ логов LocalStack

Параметры

analysisTypeenum
The analysis to perform: 'summary' (default), 'errors', 'requests', or 'logs' for raw output.
filterstring
Raw keyword filter. Only used with 'logs' mode.
linesinteger
Number of recent log lines to fetch and analyze.
operationstring
Filter by a specific API operation (e.g., 'CreateBucket'). Requires 'service'. Used with 'requests' mode.
servicestring
Filter by AWS service (e.g., 's3', 'lambda'). Used with 'errors' and 'requests' modes.

localstack-management

Управление жизненным циклом LocalStack: запуск, остановка, перезапуск или проверка статуса.

LocalStack Management

Параметры

actionenumобязательный
The LocalStack management action to perform
envVarsobject
Additional environment variables as key-value pairs (only for start action)
serviceenum
The LocalStack stack/service to manage. Use 'aws' for the default AWS emulator, or 'snowflake' for the Snowflake emulator.

localstack-snowflake-client

Выполняет SQL-запросы и команды к эмулятору Snowflake от LocalStack через Snowflake CLI (snow). Используйте этот инструмент для SELECT-запросов, DDL (CREATE/DROP), DML (INSERT/UPDATE/DELETE), SHOW DATABASES/SCHEMAS/TABLES, DESCRIBE TABLE и любых других SQL-команд Snowflake.

LocalStack Snowflake Client

Параметры

actionenumобязательный
Action to perform
databasestring
Snowflake database context for this query.
file_pathstring
Absolute path to a .sql file to execute. Required when action is 'execute' and query is not provided.
querystring
SQL query to execute (e.g. 'SELECT * FROM mytable', 'SHOW DATABASES', 'CREATE TABLE ...'). Required when action is 'execute' and file_path is not provided.
rolestring
Snowflake role to use for this query.
schemastring
Snowflake schema context for this query.
warehousestring
Snowflake warehouse to use for this query.

localstack-state-management

Экспорт, импорт, сброс и проверка состояния LocalStack с помощью локальных файловых рабочих процессов на диске.

Управление состоянием LocalStack

Параметры

actionenumобязательный
The local LocalStack state action to perform through the LocalStack State REST API. Use this tool for file-based state export/import workflows on disk. Use Cloud Pods instead when the user wants remote cloud-backed state snapshots.
file_pathstring
Local file path for state export or import. Required for import. For export, defaults to ls-state-export in the MCP server working directory if omitted.
servicesstring[] | string
Optional AWS service names for service-level granularity, such as ['s3', 'lambda'] or 's3,lambda'. Supported for export, reset, and inspect. Import restores the services contained in the state file.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@localstack/localstack-mcp-server"
  ],
  "env": {
    "LOCALSTACK_AUTH_TOKEN": "<YOUR_TOKEN>"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот сервер позволяет AI-агенту управлять LocalStack — локальной эмуляцией облачных сервисов AWS. Вместо ручных скриптов и консоли разработчик говорит агенту на естественном языке: запустить стек, развернуть инфраструктуру через Terraform или CDK, найти ошибку в логах, сгенерировать IAM-политику или внести сбой для проверки отказоустойчивости. Всё работает через MCP из любого совместимого клиента.

Информация о сервере

Номер в рейтинге: #186
Звезд на Github: 27
Форков на Github: 13
Загрузок: 9 023
Язык реализации: TypeScript
Лицензия: Apache-2.0
Официальный сервер: Да
Дата обновления данных: 08.09 в 00:04
Идентификатор: 2D8Bcu6coP9C3hsN
Категории: CI/CD и DevOps, Автоматизация приложений, Агенты для программирования, Безопасность, Виртуализация, Инструменты для разработчиков, Мониторинг, Наблюдаемость, Облачные платформы, Сети и инфраструктура, Тестирование и QA