add localstack extensions tool (#12)

HarshCasper · web-flow · commit 8be6aaff2ec0 · 2026-02-23T19:13:29.000+05:30
diff --git a/README.md b/README.md
@@ -5,10 +5,6 @@
 
 A [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP) server that provides tools to manage and interact with your [LocalStack for AWS](https://www.localstack.cloud/localstack-for-aws) container for simplified local cloud development and testing. The LocalStack MCP Server provides simplified integration between MCP-compatible apps and your local LocalStack for AWS development environment, enabling secure and direct communication with LocalStack's emulated services and additional developer experience features.
 
-<a href="https://glama.ai/mcp/servers/@localstack/localstack-mcp-server">
-  <img width="380" height="200" src="https://glama.ai/mcp/servers/@localstack/localstack-mcp-server/badge" alt="LocalStack Server MCP server" />
-</a>
-
 This server eliminates custom scripts and manual LocalStack management with direct access to:
 
 - Start, stop, restart, and monitor LocalStack for AWS container status with built-in auth.
@@ -17,6 +13,7 @@ This server eliminates custom scripts and manual LocalStack management with dire
 - Parse logs, catch errors, and auto-generate IAM policies from violations. (requires active license)
 - Inject chaos faults and network effects into LocalStack to test system resilience. (requires active license)
 - Manage LocalStack state snapshots via [Cloud Pods](https://docs.localstack.cloud/aws/capabilities/state-management/cloud-pods/) for development workflows. (requires active license)
+- Install, remove, list, and discover [LocalStack Extensions](https://docs.localstack.cloud/aws/capabilities/extensions/) from the marketplace. (requires active license)
 - Connect AI assistants and dev tools for automated cloud testing workflows.
 
 ## Tools Reference
@@ -31,7 +28,8 @@ This server provides your AI with dedicated tools for managing your LocalStack e
 | [`localstack-iam-policy-analyzer`](./src/tools/localstack-iam-policy-analyzer.ts) | Handles IAM policy management and violation remediation                    | - Set IAM enforcement levels including `enforced`, `soft`, and `disabled` modes<br/>- Search logs for permission-related violations<br/>- Generate IAM policies automatically from detected access failures<br/>- Requires a valid LocalStack Auth Token                                                                                                                  |
 | [`localstack-chaos-injector`](./src/tools/localstack-chaos-injector.ts)           | Injects and manages chaos experiment faults for system resilience testing  | - Inject, add, remove, and clear service fault rules<br/>- Configure network latency effects<br/>- Comprehensive fault targeting by service, region, and operation<br/>- Built-in workflow guidance for chaos experiments<br/>- Requires a valid LocalStack Auth Token                                                                                                                                                     |
 | [`localstack-cloud-pods`](./src/tools/localstack-cloud-pods.ts)                   | Manages LocalStack state snapshots for development workflows               | - Save current state as Cloud Pods<br/>- Load previously saved Cloud Pods instantly<br/>- Delete Cloud Pods or reset to a clean state<br/>- Requires a valid LocalStack Auth Token                                                                                                                                                                                        |
-| [`localstack-aws-client`](./src/tools/localstack-aws-client.ts)                   | Runs AWS CLI commands inside the LocalStack container                      | - Executes commands via `awslocal` inside the running container<br/>- Sanitizes commands to block shell chaining<br/>- Auto-detects LocalStack coverage errors and links to docs                                                                                                                                                                                            |
+| [`localstack-extensions`](./src/tools/localstack-extensions.ts)                   | Installs, uninstalls, lists, and discovers LocalStack Extensions           | - Manage installed extensions via CLI actions (`list`, `install`, `uninstall`)<br/>- Browse the LocalStack Extensions marketplace (`available`)<br/>- Requires a valid LocalStack Auth Token support                                                                                                                        |
+| [`localstack-aws-client`](./src/tools/localstack-aws-client.ts)                   | Runs AWS CLI commands inside the LocalStack for AWS container              | - Executes commands via `awslocal` inside the running container<br/>- Sanitizes commands to block shell chaining<br/>- Auto-detects LocalStack coverage errors and links to docs                                                                                                                                                                                            |
 | [`localstack-docs`](./src/tools/localstack-docs.ts)                               | Searches LocalStack documentation through CrawlChat                        | - Queries LocalStack docs through a public CrawlChat collection<br/>- Returns focused snippets with source links only<br/>- Helps answer coverage, configuration, and setup questions without requiring LocalStack runtime                                                                                                                                                |
 
 ## Installation
@@ -45,7 +43,7 @@ For other MCP Clients, refer to the [configuration guide](#configuration).
 
 - [LocalStack CLI](https://docs.localstack.cloud/getting-started/installation/#localstack-cli) and Docker installed in your system path
 - [`cdklocal`](https://github.com/localstack/aws-cdk-local) or [`tflocal`](https://github.com/localstack/terraform-local) installed in your system path for running infrastructure deployment tooling
-- A [valid LocalStack Auth Token](https://docs.localstack.cloud/aws/getting-started/auth-token/) to enable Pro services IAM Policy Analyzer, Cloud Pods, and Chaos Injector tools (**optional**)
+- A [valid LocalStack Auth Token](https://docs.localstack.cloud/aws/getting-started/auth-token/) to enable Pro services, IAM Policy Analyzer, Cloud Pods, Chaos Injector, and Extensions tools (**optional**)
 - [Node.js v22.x](https://nodejs.org/en/download/) installed in your system path
 
 ### Configuration
@@ -109,4 +107,8 @@ Built on the [XMCP](https://github.com/basementstudio/xmcp) framework, you can a
 
 ## License
 
-[Apache License 2.0](./LICENSE)
+[Apache License 2.0](./LICENSE)
+
+<a href="https://glama.ai/mcp/servers/@localstack/localstack-mcp-server">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@localstack/localstack-mcp-server/badge" alt="LocalStack Server MCP server" />
+</a>
diff --git a/manifest.json b/manifest.json
@@ -47,6 +47,10 @@
       "name": "localstack-cloud-pods",
       "description": "Manages LocalStack state snapshots (Cloud Pods) for saving, loading, deleting, and resetting"
     },
+    {
+      "name": "localstack-extensions",
+      "description": "Install, uninstall, list, and discover LocalStack Extensions from the marketplace"
+    },
     {
       "name": "localstack-docs",
       "description": "Search the LocalStack documentation to find guides, API references, and configuration details"
@@ -121,6 +125,28 @@
       "arguments": ["action", "pod_name"],
       "text": "Please ${arguments.action} Cloud Pod in the LocalStack container with the pod name ${arguments.pod_name}."
     },
+    {
+      "name": "extensions-list",
+      "description": "List installed LocalStack extensions",
+      "text": "List all LocalStack extensions currently installed on my machine."
+    },
+    {
+      "name": "extensions-available",
+      "description": "Browse available LocalStack extensions",
+      "text": "Show me the available extensions in the LocalStack marketplace."
+    },
+    {
+      "name": "extensions-install",
+      "description": "Install a LocalStack extension",
+      "arguments": ["extension_name"],
+      "text": "Install the LocalStack extension ${arguments.extension_name}."
+    },
+    {
+      "name": "extensions-uninstall",
+      "description": "Uninstall a LocalStack extension",
+      "arguments": ["extension_name"],
+      "text": "Uninstall the LocalStack extension ${arguments.extension_name}."
+    },
     {
       "name": "localstack-docs-search",
       "description": "Search LocalStack documentation",
diff --git a/src/lib/localstack/license-checker.ts b/src/lib/localstack/license-checker.ts
@@ -7,6 +7,7 @@ export enum ProFeature {
   IAM_ENFORCEMENT = "localstack.platform.plugin/iam-enforcement",
   CLOUD_PODS = "localstack.platform.plugin/pods",
   CHAOS_ENGINEERING = "localstack.platform.plugin/chaos",
+  EXTENSIONS = "localstack.platform.plugin/extensions",
 }
 
 export interface LicenseCheckResult {
diff --git a/src/tools/localstack-extensions.ts b/src/tools/localstack-extensions.ts

Original file line number	Diff line number	Diff line change
`@@ -7,6 +7,7 @@ export enum ProFeature {`
`7`	`7`	`IAM_ENFORCEMENT = "localstack.platform.plugin/iam-enforcement",`
`8`	`8`	`CLOUD_PODS = "localstack.platform.plugin/pods",`
`9`	`9`	`CHAOS_ENGINEERING = "localstack.platform.plugin/chaos",`
	`10`	`+ EXTENSIONS = "localstack.platform.plugin/extensions",`
`10`	`11`	`}`
`11`	`12`
`12`	`13`	`export interface LicenseCheckResult {`