Localstack MCP Server

🚀 LocalStack MCP Server

A Model Context Protocol server that simplifies local cloud development and testing by providing tools to manage LocalStack containers and perform related tasks. It enables seamless integration between Model Context Protocol-compatible apps and your local AWS development environment, facilitating secure and direct access to LocalStack's features.

This server streamlines the process by eliminating custom scripts and manual LocalStack management, offering direct access to the following capabilities:

• Start, stop, restart, and monitor the LocalStack container with built-in authentication.
• Automatically detect configurations and deploy CDK and Terraform projects.
• Parse logs, identify errors, and auto-generate IAM policies from violations.
• Inject chaos faults and network effects to test system resilience.
• Manage LocalStack state snapshots using Cloud Pods for development workflows.
• Connect AI assistants and development tools for automated cloud testing.

✨ Features

This server equips your AI with specialized tools for managing your LocalStack environment:

📦 Installation

Editor	Installation
Cursor

For other MCP Clients, refer to the configuration guide.

Prerequisites

• Install LocalStack CLI and Docker in your system path.
• Install cdklocal or tflocal in your system path for infrastructure deployment.
• Obtain a valid LocalStack Auth Token to enable Pro services such as IAM Policy Analyzer, Cloud Pods, and Chaos Injector tools (optional).
• Install Node.js v22.x in your system path.

Configuration

Add the following configuration to your MCP client's configuration file (e.g., ~/.cursor/mcp.json). This setup uses npx to run the server, which will automatically download and install the package if it's not already present:

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "npx",
      "args": ["-y", "@localstack/localstack-mcp-server"]
    }
  }
}

If you've installed from source, adjust the command and args to point to your local build:

{
  "mcpServers": {
    "localstack-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/localstack-mcp-server/dist/stdio.js"]
    }
  }
}

Enabling Licensed Features

To activate LocalStack's licensed features, you must add your LocalStack Auth Token to the environment variables. You can obtain your token by following the official documentation.

Here's how to add your LocalStack Auth Token to the environment variables:

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

🤝 Contributing

We welcome pull requests on GitHub! To get started:

• Install Git and Node.js.
• Clone the repository.
• Install dependencies using yarn.
• Build the project with yarn build.

Built on the XMCP framework, you can add new tools by creating a new file in the src/tools directory and documenting it in the manifest.json file.

📄 License

Apache License 2.0