LocalStack MCP
by LocalStack
Manage local AWS environments — deploy, test, and debug cloud infrastructure without leaving your AI workflow
cloud Node.js Intermediate Self-hostable No API key
⭐ 18 stars 📅 Updated: 1mo ago
Description
MCP server for managing local AWS development environments powered by LocalStack. Start and stop LocalStack containers, deploy CDK and Terraform stacks locally, analyze container logs, generate IAM policies from access violations, test application resilience via chaos injection, and snapshot or restore entire environments using Cloud Pods. This server turns your AI assistant into a local cloud operations center — you can iterate on AWS infrastructure without incurring cloud costs or waiting for deployments. Supports both free-tier LocalStack Community and Pro features with an optional auth token. Essential for cloud developers who want fast, local feedback loops on their AWS infrastructure.
✅ Best for
Cloud developers who want to iterate on AWS infrastructure locally with AI assistance
⏭️ Skip if
You deploy directly to AWS and do not use local cloud emulation
💡 Use cases
- Deploying and testing CDK/Terraform stacks locally through AI conversations
- Debugging AWS service interactions by analyzing LocalStack logs
- Generating least-privilege IAM policies from observed access patterns
- Testing application resilience with chaos engineering via AI-driven injection
👍 Pros
- ✓ No AWS costs — all cloud services run locally in Docker
- ✓ Comprehensive toolset covering deployment, debugging, chaos testing, and snapshots
- ✓ Simple install via npx with standard MCP stdio transport
- ✓ Apache-2.0 license — permissive for all use cases
👎 Cons
- ✗ Requires Docker running locally for LocalStack containers
- ✗ Some advanced features (Cloud Pods, chaos injection) require LocalStack Pro
- ✗ LocalStack does not perfectly emulate all AWS services
🔧 Exposed tools (9 tools)
| Tool | Category | Description |
|---|---|---|
| localstack_logs_analysis | debugging | Analyze LocalStack container logs for errors and insights |
| localstack_deployer | deployment | Deploy CDK and Terraform stacks to the local environment |
| localstack_aws_client | interaction | Execute AWS CLI commands against the local environment |
| localstack_management | management | Start, stop, and manage LocalStack containers |
| localstack_cloud_pods | management | Snapshot and restore entire LocalStack environments |
| localstack_extensions | management | Manage LocalStack extensions and plugins |
| localstack_docs | reference | Search and retrieve LocalStack documentation |
| localstack_iam_policy_analyzer | security | Generate IAM policies from observed access violations |
| localstack_chaos_injector | testing | Inject chaos (latency, errors, outages) into local AWS services |
⚡ Installation
Prerequisites:
- • Node.js v18+
- • Docker (for running LocalStack containers)
Check Claude Code documentation to configure this MCP server.
💡 Tips & tricks
Install with `npx -y @localstack/localstack-mcp-server`. Make sure Docker is running before starting. Use the Cloud Pods feature to snapshot working environments and share them with your team for reproducible local setups.
🔄 Alternatives
Quick info
- Author
- LocalStack
- License
- Apache-2.0
- Runtime
- Node.js 18+
- Transport
- stdio
- Category
- cloud
- Difficulty
- Intermediate
- Self-hostable
- ✅
- Auth
- —
- Docker
- —
- Version
- latest
- Updated
- Feb 28, 2026
Client compatibility
- ✅ Claude Code
- ✅ Cursor
- ✅ VS Code Copilot
- ❓ Gemini CLI
- ❓ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Platforms
🍎 macOS 🐧 Linux 🪟 Windows