Localstack MCP Server

🚀 LocalStack MCP Server

LocalStack MCP Server 是一个 模型上下文协议 服务器，它提供了管理 LocalStack 容器及其他相关任务的工具，旨在简化本地云开发和测试。该服务器简化了与模型上下文协议兼容的应用程序和本地 AWS 开发环境之间的集成，实现了与 LocalStack 各种功能的安全、直接通信。

此服务器通过直接访问以下功能，消除了自定义脚本和手动 LocalStack 管理的麻烦：

• 通过内置身份验证启动、停止、重启和监控 LocalStack 容器状态。
• 自动检测配置，部署 CDK 和 Terraform 项目。
• 解析日志、捕获错误，并根据违规行为自动生成 IAM 策略。
• 向 LocalStack 注入混沌故障和网络影响，以测试系统的弹性。
• 通过云容器（Cloud Pods）管理 LocalStack 状态快照，用于开发工作流。
• 连接 AI 助手和开发工具，实现自动化云测试工作流。

✨ 主要特性

🛠️ 工具参考

该服务器为您的 AI 提供了用于管理 LocalStack 环境的专用工具：

📦 安装指南

编辑器安装

编辑器	安装方式
Cursor

对于其他 MCP 客户端，请参考 配置指南。

前提条件

• 系统路径中安装了 LocalStack CLI 和 Docker。
• 系统路径中安装了 cdklocal 或 tflocal，用于运行基础设施部署工具。
• （可选）拥有 有效的 LocalStack 身份验证令牌，以启用 Pro 服务的 IAM 策略分析器、云容器和混沌注入器工具。
• 系统路径中安装了 Node.js v22.x。

配置

将以下内容添加到您的 MCP 客户端配置文件（例如 ~/.cursor/mcp.json）中。此配置使用 npx 运行服务器，如果包尚未存在，将自动下载并安装：

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

如果您从源代码安装，请更改 command 和 args 以指向您的本地构建：

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

启用许可功能

要激活 LocalStack 许可功能，您需要将 LocalStack 身份验证令牌添加到环境变量中。您可以按照官方 文档 获取 LocalStack 身份验证令牌。

以下是将 LocalStack 身份验证令牌添加到环境变量的方法：

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

🤝 贡献代码

欢迎在 GitHub 上提交拉取请求！开始贡献的步骤如下：

• 安装 Git 和 Node.js。
• 克隆仓库。
• 使用 yarn 安装依赖项。
• 使用 yarn build 进行构建。

该项目基于 XMCP 框架构建，您可以通过在 src/tools 目录中添加新文件并在 manifest.json 文件中进行文档记录来添加新工具。

📄 许可证

Apache License 2.0