Happy slice of mcp pizzaMCP.pizza
localstack-mcp-server

localstack-mcp-server

MCP.Pizza Chef: localstack

Run and manage LocalStack, a local cloud emulator, directly through your AI assistant in apps like Claude Desktop, Cursor, or VS Code. You can start or stop LocalStack, deploy infrastructure projects like Terraform or CDK, analyze logs for errors, and even inject faults to test your applications. This requires Docker and some setup but lets you handle your local cloud environment naturally without manual commands.

Coding
Other

Use This MCP server To

Start and stop LocalStack from my AI assistant Deploy Terraform, CDK, or SAM projects locally Analyze LocalStack logs for errors and fixes Inject network faults to test system resilience Manage LocalStack state snapshots and exports Search LocalStack documentation via AI Install and manage LocalStack extensions

README

LocalStack MCP Server

LocalStack MCP Server

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

npm version License: Apache-2.0 MCP Registry

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.

What you can ask your agent

Once the server is configured, talk to LocalStack through your agent in natural language:

  • "Start LocalStack and deploy the Terraform project in ./infra, then tell me which resources came up."
  • "My Lambda calls are failing. Read the LocalStack logs, find the permission errors, and generate an IAM policy that fixes them."
  • "Inject 500ms of latency into DynamoDB and confirm my retry logic still works."
  • "Search the LocalStack docs for how to enable S3 event notifications and summarize the steps."

localstack-mcp-server FAQ

Can I use this to start and manage LocalStack from my AI assistant?
Yes — you can start, stop, and monitor LocalStack directly through your assistant in apps like Claude Desktop, Cursor, or VS Code.
Can I deploy infrastructure projects like Terraform or CDK using this?
Yes — it supports deploying CDK, Terraform, and SAM projects locally if you have the related tools installed.
Do I need an API key or account to use this?
Yes — you must have a valid LocalStack Auth Token set as LOCALSTACK_AUTHTOKEN in your environment.
Which apps can I use this with?
It works with MCP-compatible clients such as Claude Desktop, Cursor, and VS Code.
How hard is it to set up?
Setup requires developer skills since you need Docker running, install prerequisites, and configure environment variables.
Can I analyze logs and generate fixes using this?
Yes — your assistant can read LocalStack logs, find errors, and help generate IAM policies to fix issues.