JinDaGe - localstack-mcp-server MCP Details

article

README

🚀 LocalStack MCP Server

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

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

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

✨ 主要特性

🛠️ 工具参考

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

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

🤝 贡献代码

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

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

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

📄 许可证

Apache License 2.0

localstack-mcp-server