Localstack MCP Server

🚀 LocalStack MCP Server

Model Context Protocolサーバーです。このサーバーは、LocalStackコンテナの管理やその他の関連タスクを容易に行うためのツールを提供し、ローカルのクラウド開発とテストを簡素化します。LocalStack MCP Serverは、Model Context Protocolに対応したアプリとローカルのAWS開発環境とのシンプルな統合を実現し、LocalStackの様々な機能との安全で直接的な通信を可能にします。

このサーバーを使用することで、以下の機能に直接アクセスでき、カスタムスクリプトや手動によるLocalStackの管理を不要にします。

• 組み込み認証付きでLocalStackコンテナの起動、停止、再起動、および状態監視。
• CDKとTerraformプロジェクトを自動設定検出でデプロイ。
• ログを解析し、エラーをキャッチし、違反から自動的にIAMポリシーを生成。
• LocalStackに混乱障害とネットワーク効果を注入して、システムの回復力をテスト。
• 開発ワークフロー用にCloud Podsを介してLocalStackの状態スナップショットを管理。
• AIアシスタントと開発ツールを接続して、自動化されたクラウドテストワークフローを実行。

✨ 主な機能

このサーバーは、LocalStack環境を管理するための専用ツールをAIに提供します。

📦 インストール

エディター	インストール方法
Cursor

他のMCPクライアントの場合は、設定ガイドを参照してください。

前提条件

• システムパスにLocalStack CLIとDockerがインストールされていること。
• インフラストラクチャデプロイツールを実行するために、システムパスにcdklocalまたはtflocalがインストールされていること。
• ProサービスのIAMポリシーアナライザー、Cloud Pods、および混乱インジェクターツールを有効にするための有効なLocalStack認証トークン（オプション）。
• システムパスに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