🚀 LocalStack MCP Server
LocalStack MCP Server 是一个 模型上下文协议 服务器，它提供了管理 LocalStack 容器及其他相关任务的工具，旨在简化本地云开发和测试。该服务器简化了与模型上下文协议兼容的应用程序和本地 AWS 开发环境之间的集成，实现了与 LocalStack 各种功能的安全、直接通信。
此服务器通过直接访问以下功能，消除了自定义脚本和手动 LocalStack 管理的麻烦：
- 通过内置身份验证启动、停止、重启和监控 LocalStack 容器状态。
- 自动检测配置，部署 CDK 和 Terraform 项目。
- 解析日志、捕获错误，并根据违规行为自动生成 IAM 策略。
- 向 LocalStack 注入混沌故障和网络影响，以测试系统的弹性。
- 通过云容器（Cloud Pods）管理 LocalStack 状态快照，用于开发工作流。
- 连接 AI 助手和开发工具，实现自动化云测试工作流。
✨ 主要特性
🛠️ 工具参考
该服务器为您的 AI 提供了用于管理 LocalStack 环境的专用工具：
| 工具名称 | 描述 | 主要特性 |
|---|---|---|
| 管理 LocalStack 容器操作和设置 | - 执行启动、停止、重启和状态检查 - 集成 LocalStack Pro 身份验证令牌 - 注入自定义环境变量 - 验证实时状态并进行健康监控 |
|
| 处理向 LocalStack 环境的基础设施部署 | - 自动运行 CDK 和 Terraform 工具，在本地部署基础设施 - 支持带变量的参数化部署 - 处理并展示部署结果 - 要求您的系统路径中安装了 cdklocal 或 tflocal |
|
| 分析 LocalStack 日志，用于故障排除和洞察 | - 提供多种分析选项，包括摘要、错误、请求和原始数据 - 按特定服务和操作进行过滤 - 生成 API 调用指标和故障明细 - 智能分组错误并识别模式 |
|
| 处理 IAM 策略管理和违规修复 | - 设置 IAM 强制级别，包括 enforced、soft 和 disabled 模式- 在日志中搜索与权限相关的违规行为 - 根据检测到的访问失败自动生成 IAM 策略 - 需要有效的 LocalStack 身份验证令牌 |
|
| 注入和管理混沌工程故障，用于系统弹性测试 | - 注入、添加、移除和清除服务故障规则 - 配置网络延迟影响 - 按服务、区域和操作进行全面故障定位 - 内置混沌实验工作流指南 |
|
| 管理 LocalStack 状态快照，用于开发工作流 | - 将当前状态保存为云容器（Cloud Pods） - 立即加载以前保存的云容器 - 删除云容器或重置为干净状态 - 需要有效的 LocalStack 身份验证令牌 |
|
| 在 LocalStack 容器内运行 AWS CLI 命令 | - 通过运行中的容器内的 awslocal 执行命令- 清理命令以阻止 shell 链式操作 - 自动检测 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": ""
}
}
}
}
🤝 贡献代码
欢迎在 GitHub 上提交拉取请求！开始贡献的步骤如下：
- 安装 Git 和 Node.js。
- 克隆仓库。
- 使用
yarn安装依赖项。 - 使用
yarn build进行构建。
该项目基于 XMCP 框架构建，您可以通过在 src/tools 目录中添加新文件并在 manifest.json 文件中进行文档记录来添加新工具。
📄 许可证
Apache License 2.0