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