LocalStack MCP 服务器

[!IMPORTANT] LocalStack MCP 服务器目前作为实验性公开预览版提供。如有问题、反馈或建议，请使用 LocalStack 社区 Slack 或提交 GitHub Issue

一个提供工具来管理和与您的 LocalStack for AWS 容器交互的 Model Context Protocol (MCP) 服务器，简化本地云开发和测试。LocalStack MCP 服务器提供了 MCP 兼容应用程序与您本地 LocalStack for AWS 开发环境之间的简化集成，支持安全且直接地与 LocalStack 模拟服务通信以及额外的开发者体验功能。

此服务器消除了自定义脚本和手动管理 LocalStack 的需求，并提供了直接访问以下功能：

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

工具参考

此服务器为您的 AI 提供了专门的工具来管理 LocalStack 环境：

工具名称	描述	主要特性
localstack-management	管理 LocalStack for AWS 容器操作和设置	- 执行启动、停止、重启和状态检查<br/>- 集成 LocalStack 认证令牌<br/>- 注入自定义环境变量<br/>- 验证实时状态并执行健康监控
localstack-deployer	处理基础设施部署到 LocalStack for AWS 环境	- 自动运行 CDK 和 Terraform 工具以在本地部署基础设施<br/>- 支持参数化部署和变量支持<br/>- 处理并展示部署结果<br/>- 需要在系统路径中安装有 cdklocal 或 tflocal
localstack-logs-analysis	分析 LocalStack for AWS 日志以进行故障排除和洞察	- 提供多种分析选项，包括摘要、错误、请求和原始数据<br/>- 按特定服务和操作过滤<br/>- 生成 API 调用指标和失败分解<br/>- 智能分组错误并识别模式
localstack-iam-policy-analyzer	处理 IAM 策略管理和违规补救	- 设置 IAM 执行级别，包括 enforced、soft 和 disabled 模式<br/>- 在日志中搜索权限相关违规行为<br/>- 根据检测到的访问失败自动生成 IAM 策略<br/>- 需要有有效的 LocalStack 认证令牌
localstack-chaos-injector	注入和管理混沌实验故障以测试系统弹性	- 注入、添加、移除和清除服务故障规则<br/>- 配置网络延迟效果<br/>- 通过服务、区域和操作全面定位故障<br/>- 内置混沌实验工作流程指导<br/>- 需要有有效的 LocalStack 认证令牌
localstack-cloud-pods	管理 LocalStack 状态快照以用于开发工作流	- 将当前状态保存为 Cloud Pods<br/>- 即时加载之前保存的 Cloud Pods<br/>- 删除 Cloud Pods 或重置为干净状态<br/>- 需要有有效的 LocalStack 认证令牌
localstack-aws-client	在 LocalStack for AWS 容器内运行 AWS CLI 命令	- 通过 awslocal 在运行容器内执行命令<br/>- 清理命令以阻止 shell 链接<br/>- 自动检测 LocalStack 覆盖错误并链接到文档

安装

编辑器	安装
Cursor
对于其他 MCP 客户端，请参阅 配置指南。

先决条件

• 在系统路径中安装 LocalStack CLI 和 Docker
• 在系统路径中安装有 cdklocal 或 tflocal，用于运行基础设施部署工具
• 一个 有效的 LocalStack 认证令牌，以启用 Pro 服务 IAM 策略分析器、Cloud Pods 和混沌注入器工具（可选）
• 在系统路径中安装有 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 许可证 2.0