@aws/nx-plugin 0.23.0 → 0.24.0

package/LICENSE-THIRD-PARTY

@@ -3556,6 +3556,33 @@ THE SOFTWARE.
 
 ---
 
+The following software may be included in this product: @modelcontextprotocol/sdk (1.11.3)
+This software contains the following license and notice below:
+
+MIT License
+
+Copyright (c) 2024 Anthropic, PBC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
 The following software may be included in this product: @modern-js/node-bundle-require (2.65.1)
 This software contains the following license and notice below:
 
@@ -4793,34 +4820,6 @@ SOFTWARE.
 
 ---
 
-The following software may be included in this product: @nx/devkit (20.6.4)
-This software contains the following license and notice below:
-
-(The MIT License)
-
-Copyright (c) 2017-2025 Narwhal Technologies Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
----
-
 The following software may be included in this product: @nx/devkit (21.0.3)
 This software contains the following license and notice below:
 
@@ -5060,7 +5059,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ---
 
-The following software may be included in this product: @nxlv/python (20.12.0)
+The following software may be included in this product: @nxlv/python (21.0.0)
 This software contains the following license and notice below:
 
 MIT License
@@ -11616,6 +11615,61 @@ USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ---
 
+The following software may be included in this product: eventsource (3.0.7)
+This software contains the following license and notice below:
+
+The MIT License
+
+Copyright (c) EventSource GitHub organisation
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+The following software may be included in this product: eventsource-parser (3.0.2)
+This software contains the following license and notice below:
+
+MIT License
+
+Copyright (c) 2025 Espen Hovlandsdal <espen@hovlandsdal.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
 The following software may be included in this product: expand-tilde (2.0.2)
 This software contains the following license and notice below:
 
@@ -11686,6 +11740,32 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ---
 
+The following software may be included in this product: express-rate-limit (7.5.0)
+This software contains the following license and notice below:
+
+# MIT License
+
+Copyright 2023 Nathan Friedly, Vedant K
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
 The following software may be included in this product: extend (3.0.2)
 This software contains the following license and notice below:
 
@@ -18047,6 +18127,33 @@ SOFTWARE.
 
 ---
 
+The following software may be included in this product: pkce-challenge (5.0.0)
+This software contains the following license and notice below:
+
+MIT License
+
+Copyright (c) 2019
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
 The following software may be included in this product: pkg-types (1.3.1)
 This software contains the following license and notice below:
 
@@ -18666,6 +18773,34 @@ THE SOFTWARE.
 
 ---
 
+The following software may be included in this product: raw-body (3.0.0)
+This software contains the following license and notice below:
+
+The MIT License (MIT)
+
+Copyright (c) 2013-2014 Jonathan Ong <me@jongleberry.com>
+Copyright (c) 2014-2022 Douglas Christopher Wilson <doug@somethingdoug.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+---
+
 The following software may be included in this product: rc9 (2.1.2)
 This software contains the following license and notice below:
 
@@ -28380,6 +28515,33 @@ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLI
 
 ---
 
+The following software may be included in this product: zod (3.24.2)
+This software contains the following license and notice below:
+
+MIT License
+
+Copyright (c) 2020 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
 The following software may be included in this product: @ampproject/remapping (2.3.0)
 This software contains the following license and notice below:
 
@@ -35809,6 +35971,27 @@ ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 ---
 
+The following software may be included in this product: zod-to-json-schema (3.24.5)
+This software contains the following license and notice below:
+
+ISC License
+
+Copyright (c) 2020, Stefan Terdell
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
 The following software may be included in this product: @xtuc/ieee754 (1.2.0)
 This software contains the following license and notice below:
 

package/README.md

@@ -100,6 +100,28 @@ pnpm nx g @aws/nx-plugin:ts#infra
 - [Build a Dungeon Adventure Game](https://awslabs.github.io/nx-plugin-for-aws/get_started/tutorials/dungeon-game/overview/) to get an in-depth guided tutorial on how to use the @aws/nx-plugin.
 - [Add @aws/nx-plugin to your existing project](https://awslabs.github.io/nx-plugin-for-aws/get_started/tutorials/existing-project/)
 
+## MCP Server Installation and Setup
+
+This package additionally provides an MCP server to help AI assistants use the Nx Plugin for AWS.
+
+1. Ensure you have `node` and `npm` installed ([see here](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm))
+2. Add the server to your MCP client configuration
+
+Example configuration for Amazon Q CLI MCP (`~/.aws/amazonq/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "aws-nx-mcp": {
+      "command": "npx",
+      "args": ["-p", "@aws/nx-plugin", "aws-nx-mcp"]
+    }
+  }
+}
+```
+
+If you have issues such as `ENOENT npx`, replace the command with `/full/path/to/npx` (use `which npx` to find this).
+
 ## Documentation Translation
 
 The project supports automatic translation of documentation using AWS Bedrock's Deepseek & Haiku 3.5 models. Documentation is translated from English to multiple languages (currently Japanese, with support for French, Spanish, German, Chinese, and Korean).

package/bin/aws-nx-mcp.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/bin/aws-nx-mcp.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const mcp_server_1 = require("../src/mcp-server");
+void (() => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield (0, mcp_server_1.startMcpServer)();
+    }
+    catch (e) {
+        console.error(e);
+    }
+}))();
+//# sourceMappingURL=aws-nx-mcp.js.map

package/bin/aws-nx-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-nx-mcp.js","sourceRoot":"","sources":["../../../../packages/nx-plugin/bin/aws-nx-mcp.ts"],"names":[],"mappings":";;;;AACA;;;GAGG;AACH,kDAAmD;AAEnD,KAAK,CAAC,GAAS,EAAE;IACf,IAAI,CAAC;QACH,MAAM,IAAA,2BAAc,GAAE,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC,CAAA,CAAC,EAAE,CAAC"}

package/generators.json

@@ -7,19 +7,22 @@
       "factory": "./src/ts/lib/generator",
       "schema": "./src/ts/lib/schema.json",
       "description": "Generates a TypeScript project",
-      "metric": "g1"
+      "metric": "g1",
+      "guidePages": ["typescript-project"]
     },
     "py#project": {
       "factory": "./src/py/project/generator",
       "schema": "./src/py/project/schema.json",
       "description": "Generates a Python project",
-      "metric": "g2"
+      "metric": "g2",
+      "guidePages": ["python-project"]
     },
     "py#fast-api": {
       "factory": "./src/py/fast-api/generator",
       "schema": "./src/py/fast-api/schema.json",
       "description": "Generates a FastAPI Python project",
-      "metric": "g3"
+      "metric": "g3",
+      "guidePages": ["fastapi"]
     },
     "py#fast-api#react-connection": {
       "factory": "./src/py/fast-api/react/generator",
@@ -32,13 +35,15 @@
       "factory": "./src/cloudscape-website/app/generator",
       "schema": "./src/cloudscape-website/app/schema.json",
       "description": "Generates a React static website based on Cloudscape",
-      "metric": "g5"
+      "metric": "g5",
+      "guidePages": ["cloudscape-website"]
     },
     "ts#cloudscape-website#auth": {
       "factory": "./src/cloudscape-website/cognito-auth/generator",
       "schema": "./src/cloudscape-website/cognito-auth/schema.json",
       "description": "Adds auth to an existing cloudscape website",
-      "metric": "g6"
+      "metric": "g6",
+      "guidePages": ["cloudscape-website-auth"]
     },
     "ts#cloudscape-website#runtime-config": {
       "factory": "./src/cloudscape-website/runtime-config/generator",
@@ -51,13 +56,15 @@
       "factory": "./src/infra/app/generator",
       "schema": "./src/infra/app/schema.json",
       "description": "Generates a cdk application",
-      "metric": "g8"
+      "metric": "g8",
+      "guidePages": ["typescript-infrastructure"]
     },
     "ts#trpc-api": {
       "factory": "./src/trpc/backend/generator",
       "schema": "./src/trpc/backend/schema.json",
       "description": "creates a trpc backend",
-      "metric": "g9"
+      "metric": "g9",
+      "guidePages": ["trpc"]
     },
     "ts#trpc-api#react-connection": {
       "factory": "./src/trpc/react/generator",
@@ -70,7 +77,12 @@
       "factory": "./src/api-connection/generator",
       "schema": "./src/api-connection/schema.json",
       "description": "Integrates a source project with a target API project",
-      "metric": "g11"
+      "metric": "g11",
+      "guidePages": [
+        "api-connection",
+        "api-connection/react-fastapi",
+        "api-connection/react-trpc"
+      ]
     },
     "open-api#ts-client": {
       "factory": "./src/open-api/ts-client/generator",
@@ -103,13 +115,15 @@
       "factory": "./src/py/lambda-function/generator",
       "schema": "./src/py/lambda-function/schema.json",
       "description": "Adds a lambda function to a python project",
-      "metric": "g16"
+      "metric": "g16",
+      "guidePages": ["python-lambda-function"]
     },
     "ts#nx-generator": {
       "factory": "./src/ts/nx-generator/generator",
       "schema": "./src/ts/nx-generator/schema.json",
       "description": "Generator for adding an Nx Generator to an existing TypeScript project",
-      "metric": "g17"
+      "metric": "g17",
+      "guidePages": ["nx-generator"]
     },
     "ts#mcp-server": {
       "factory": "./src/ts/mcp-server/generator",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws/nx-plugin",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",
@@ -14,6 +14,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "bin": {
+    "aws-nx-mcp": "./bin/aws-nx-mcp.js"
+  },
   "generators": "./generators.json",
   "peerDependencies": {
     "prettier": "^3.4.2",
@@ -23,6 +26,7 @@
     "@apidevtools/swagger-parser": "^10.1.1",
     "@hey-api/openapi-ts": "0.64.13",
     "@iarna/toml": "^2.2.5",
+    "@modelcontextprotocol/sdk": "^1.11.3",
     "@nx/devkit": "~21.0.3",
     "@nx/eslint": "~21.0.3",
     "@nx/js": "~21.0.3",
@@ -42,7 +46,8 @@
     "openapi-types": "^12.1.3",
     "typescript": "~5.8.2",
     "vite": "^6.2.3",
-    "vitest": "^3.0.9"
+    "vitest": "^3.0.9",
+    "zod": "^3.24.2"
   },
   "types": "./src/index.d.ts"
 }

package/src/mcp-server/generator-info.d.ts

@@ -0,0 +1,23 @@
+import { NxGeneratorInfo } from '../utils/nx';
+/**
+ * Build a command to run nx
+ */
+export declare const buildNxCommand: (command: string, pm?: string) => string;
+/**
+ * Render summary information about a generator
+ */
+export declare const renderGeneratorInfo: (packageManager: string, info: NxGeneratorInfo) => string;
+/**
+ * Retrieve the markdown guide pages for a generator from github.
+ * If the generator has guidePages in generators.json we fetch all of those, otherwise we
+ * try to fetch a guide with the generator name kebab-cased.
+ */
+export declare const fetchGuidePagesForGenerator: (info: NxGeneratorInfo, generators: NxGeneratorInfo[], packageManager?: string) => Promise<string>;
+/**
+ * Fetch markdown guide pages from github
+ */
+export declare const fetchGuidePages: (guidePages: string[], generators: NxGeneratorInfo[], packageManager?: string) => Promise<string>;
+/**
+ * Post-process a guide page to "inline" relevant components
+ */
+export declare const postProcessGuide: (guide: string, generators: NxGeneratorInfo[], packageManager?: string) => string;

package/src/mcp-server/generator-info.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postProcessGuide = exports.fetchGuidePages = exports.fetchGuidePagesForGenerator = exports.renderGeneratorInfo = exports.buildNxCommand = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const lodash_kebabcase_1 = tslib_1.__importDefault(require("lodash.kebabcase"));
+const fs_1 = tslib_1.__importDefault(require("fs"));
+/**
+ * Build a command to run nx
+ */
+const buildNxCommand = (command, pm) => {
+    var _a;
+    return `${pm
+        ? `${(_a = {
+            npm: 'npx',
+            bun: 'bunx',
+        }[pm]) !== null && _a !== void 0 ? _a : pm} `
+        : ''}nx ${command}`;
+};
+exports.buildNxCommand = buildNxCommand;
+const renderSchema = (schema) => Object.entries(schema.properties)
+    .map(([parameter, parameterSchema]) => { var _a; return `- ${parameter} [type: ${parameterSchema.type}]${((_a = schema.required) !== null && _a !== void 0 ? _a : []).includes(parameter) ? ` (required)` : ''} ${parameterSchema.description}`; })
+    .join('\n');
+const renderGeneratorCommand = (generatorId, schema, packageManager) => `\`\`\`bash
+${(0, exports.buildNxCommand)(`g @aws/nx-plugin:${generatorId} --no-interactive ${Object.entries(schema.properties)
+    .filter(([parameter]) => { var _a; return ((_a = schema.required) !== null && _a !== void 0 ? _a : []).includes(parameter); })
+    .map(([parameter]) => `--${parameter}=<${parameter}>`)
+    .join(' ')}`, packageManager)}
+\`\`\``;
+/**
+ * Render summary information about a generator
+ */
+const renderGeneratorInfo = (packageManager, info) => {
+    const schema = JSON.parse(fs_1.default.readFileSync(info.resolvedSchemaPath, 'utf-8'));
+    return `${info.id}
+
+Description: ${info.description}
+
+Available Parameters:
+${renderSchema(schema)}
+
+Command:
+${renderGeneratorCommand(info.id, schema, packageManager)}
+`;
+};
+exports.renderGeneratorInfo = renderGeneratorInfo;
+/**
+ * Retrieve the markdown guide pages for a generator from github.
+ * If the generator has guidePages in generators.json we fetch all of those, otherwise we
+ * try to fetch a guide with the generator name kebab-cased.
+ */
+const fetchGuidePagesForGenerator = (info, generators, packageManager) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    return yield (0, exports.fetchGuidePages)((_a = info.guidePages) !== null && _a !== void 0 ? _a : [(0, lodash_kebabcase_1.default)(info.id)], generators, packageManager);
+});
+exports.fetchGuidePagesForGenerator = fetchGuidePagesForGenerator;
+/**
+ * Fetch markdown guide pages from github
+ */
+const fetchGuidePages = (guidePages, generators, packageManager) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const guides = yield Promise.allSettled(guidePages.map((guide) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+        return yield (yield fetch(`https://raw.githubusercontent.com/awslabs/nx-plugin-for-aws/refs/heads/main/docs/src/content/docs/en/guides/${guide}.mdx`)).text();
+    })));
+    return guides
+        .filter((result) => result.status === 'fulfilled')
+        .map((result) => (0, exports.postProcessGuide)(result.value, generators, packageManager))
+        .join('\n\n');
+});
+exports.fetchGuidePages = fetchGuidePages;
+const findGeneratorAndSchema = (generators, generatorId) => {
+    const generator = generators.find((info) => info.id === generatorId);
+    if (!generator) {
+        return undefined;
+    }
+    try {
+        const schema = JSON.parse(fs_1.default.readFileSync(generator.resolvedSchemaPath, 'utf-8'));
+        return { generator, schema };
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+/**
+ * Post-process a guide page to "inline" relevant components
+ */
+const postProcessGuide = (guide, generators, packageManager) => {
+    // Replace <NxCommands /> with markdown code blocks
+    let processedGuide = guide.replace(/<NxCommands\s+commands={([^}]+)}\s*\/>/g, (match, commandsMatch) => {
+        try {
+            const commands = JSON.parse(commandsMatch
+                .replaceAll("\\'", '__ESCAPED_SINGLE_QUOTE__')
+                .replaceAll("'", '"')
+                .replaceAll('__ESCAPED_SINGLE_QUOTE__', "\\'"));
+            return `\`\`\`bash\n${commands.map((command) => (0, exports.buildNxCommand)(command, packageManager)).join('\n')}\n\`\`\``;
+        }
+        catch (_a) {
+            return match;
+        }
+    });
+    // Replace <RunGenerator /> with renderGeneratorCommand
+    processedGuide = processedGuide.replace(/<RunGenerator\s+([^/>]+)\s*\/>/g, (match, attributes) => {
+        // Extract generator parameter
+        const generatorMatch = attributes.match(/generator=["']([^"']+)["']/);
+        if (!generatorMatch) {
+            return match; // If no generator parameter, leave as is
+        }
+        const generatorId = generatorMatch[1];
+        const info = findGeneratorAndSchema(generators, generatorId);
+        if (!info) {
+            return match;
+        }
+        return renderGeneratorCommand(generatorId, info.schema, packageManager);
+    });
+    // Replace <GeneratorParameters /> with renderSchema
+    processedGuide = processedGuide.replace(/<GeneratorParameters\s+([^/>]+)\s*\/>/g, (match, attributes) => {
+        // Extract generator parameter
+        const generatorMatch = attributes.match(/generator=["']([^"']+)["']/);
+        if (!generatorMatch) {
+            return match; // If no generator parameter, leave as is
+        }
+        const generatorId = generatorMatch[1];
+        const info = findGeneratorAndSchema(generators, generatorId);
+        if (!info) {
+            return match;
+        }
+        return renderSchema(info.schema);
+    });
+    return processedGuide;
+};
+exports.postProcessGuide = postProcessGuide;
+//# sourceMappingURL=generator-info.js.map

package/src/mcp-server/generator-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-info.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/generator-info.ts"],"names":[],"mappings":"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"}

package/src/mcp-server/index.d.ts

@@ -0,0 +1 @@
+export declare const startMcpServer: () => Promise<void>;

package/src/mcp-server/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startMcpServer = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_1 = require("./server");
+const startMcpServer = () => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const transport = new stdio_js_1.StdioServerTransport();
+    yield (0, server_1.createServer)().connect(transport);
+    console.error('Nx Plugin for AWS MCP Server listening on STDIO');
+});
+exports.startMcpServer = startMcpServer;
+//# sourceMappingURL=index.js.map

package/src/mcp-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/index.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,wEAAiF;AACjF,qCAAwC;AAEjC,MAAM,cAAc,GAAG,GAAS,EAAE;IACvC,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,IAAA,qBAAY,GAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;AACnE,CAAC,CAAA,CAAC;AAJW,QAAA,cAAc,kBAIzB"}

package/src/mcp-server/schema.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+export declare const PACKAGE_MANAGERS: readonly ["pnpm", "yarn", "npm", "bun"];
+export declare const PackageManagerSchema: z.ZodEnum<["pnpm", "yarn", "npm", "bun"]>;

package/src/mcp-server/schema.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageManagerSchema = exports.PACKAGE_MANAGERS = void 0;
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const zod_1 = require("zod");
+exports.PACKAGE_MANAGERS = ['pnpm', 'yarn', 'npm', 'bun'];
+exports.PackageManagerSchema = zod_1.z.enum(exports.PACKAGE_MANAGERS);
+//# sourceMappingURL=schema.js.map

package/src/mcp-server/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/schema.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,6BAAwB;AAEX,QAAA,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAC3D,QAAA,oBAAoB,GAAG,OAAC,CAAC,IAAI,CAAC,wBAAgB,CAAC,CAAC"}

package/src/mcp-server/server.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create the MCP Server
+ */
+export declare const createServer: () => McpServer;

package/src/mcp-server/server.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = void 0;
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const nx_1 = require("../utils/nx");
+const create_workspace_command_1 = require("./tools/create-workspace-command");
+const list_generators_1 = require("./tools/list-generators");
+const generator_guide_1 = require("./tools/generator-guide");
+const general_guidance_1 = require("./tools/general-guidance");
+/**
+ * Create the MCP Server
+ */
+const createServer = () => {
+    const generators = (0, nx_1.listGenerators)();
+    const server = new mcp_js_1.McpServer({
+        name: 'nx-plugin-for-aws',
+        version: '1.0.0',
+    }, {
+        instructions: `# Nx Plugin for AWS MCP Server
+
+This server provides resources and tools for quickly scaffolding AWS projects within an Nx workspace (monorepo), using the Nx Plugin for AWS (@aws/nx-plugin).
+
+The Nx Plugin for AWS provides "generators" to add projects or functionality to your workspace. Use this to build the foundations of any project you are building
+on AWS, if the generators apply to your use case.
+
+${general_guidance_1.TOOL_SELECTION_GUIDE}
+`,
+    });
+    (0, general_guidance_1.addGeneralGuidanceTool)(server, generators);
+    (0, create_workspace_command_1.addCreateWorkspaceCommandTool)(server);
+    (0, list_generators_1.addListGeneratorsTool)(server, generators);
+    (0, generator_guide_1.addGeneratorGuideTool)(server, generators);
+    return server;
+};
+exports.createServer = createServer;
+//# sourceMappingURL=server.js.map

package/src/mcp-server/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/mcp-server/server.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,oEAAoE;AACpE,oCAA6C;AAC7C,+EAAiF;AACjF,6DAAgE;AAChE,6DAAgE;AAChE,+DAGkC;AAElC;;GAEG;AACI,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,UAAU,GAAG,IAAA,mBAAc,GAAE,CAAC;IAEpC,MAAM,MAAM,GAAG,IAAI,kBAAS,CAC1B;QACE,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;;;;;;;EAOlB,uCAAoB;CACrB;KACI,CACF,CAAC;IAEF,IAAA,yCAAsB,EAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3C,IAAA,wDAA6B,EAAC,MAAM,CAAC,CAAC;IACtC,IAAA,uCAAqB,EAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC1C,IAAA,uCAAqB,EAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE1C,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AA3BW,QAAA,YAAY,gBA2BvB"}

package/src/mcp-server/tools/create-workspace-command.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Add a tool which tells a model how to create an Nx workspace
+ */
+export declare const addCreateWorkspaceCommandTool: (server: McpServer) => void;

package/src/mcp-server/tools/create-workspace-command.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCreateWorkspaceCommandTool = void 0;
+const zod_1 = require("zod");
+const schema_1 = require("../schema");
+/**
+ * Add a tool which tells a model how to create an Nx workspace
+ */
+const addCreateWorkspaceCommandTool = (server) => {
+    server.tool('create-workspace-command', { workspaceName: zod_1.z.string(), packageManager: schema_1.PackageManagerSchema }, ({ workspaceName, packageManager }) => ({
+        content: [
+            {
+                type: 'text',
+                text: `Run the following command to create a workspace:
+
+\`\`\`bash
+npx create-nx-workspace@~21.0.3 ${workspaceName} --pm=${packageManager} --preset=@aws/nx-plugin --ci=skip
+\`\`\`
+
+Note that this will create a workspace in a new directory named ${workspaceName}. If you are already working in the directory
+you would like for your workspace, you can move all the files up one level and delete the empty directory afterwards, eg:
+
+\`\`\`bash
+mv ${workspaceName}/{*,.*} ./ && rm -rf ${workspaceName}
+\`\`\`
+
+(Note that the above command will complain about moving . and .. but that is expected and ok!)
+  `,
+            },
+        ],
+    }));
+};
+exports.addCreateWorkspaceCommandTool = addCreateWorkspaceCommandTool;
+//# sourceMappingURL=create-workspace-command.js.map

package/src/mcp-server/tools/create-workspace-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-workspace-command.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/create-workspace-command.ts"],"names":[],"mappings":";;;AAKA,6BAAwB;AACxB,sCAAiD;AAEjD;;GAEG;AACI,MAAM,6BAA6B,GAAG,CAAC,MAAiB,EAAE,EAAE;IACjE,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,EAAE,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,6BAAoB,EAAE,EACnE,CAAC,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;;;kCAGkB,aAAa,SAAS,cAAc;;;kEAGJ,aAAa;;;;KAI1E,aAAa,wBAAwB,aAAa;;;;GAIpD;aACM;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AA3BW,QAAA,6BAA6B,iCA2BxC"}

package/src/mcp-server/tools/general-guidance.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { NxGeneratorInfo } from '../../utils/nx';
+export declare const TOOL_SELECTION_GUIDE = "## Tool Selection Guide\n\n- Use the `general-guidance` tool for guidance and best practices for working with Nx and the Nx Plugin for AWS.\n- Use the `create-workspace-command` tool to discover how to create a workspace to start a new project.\n- Use the `list-generators` tool to discover the available generators and how to run them.\n- Use the `generator-guide` tool to retrieve detailed information about a specific generator.";
+/**
+ * Add a tool which provides general guidance for using Nx and the Nx Plugin for AWS
+ */
+export declare const addGeneralGuidanceTool: (server: McpServer, generators: NxGeneratorInfo[]) => void;

package/src/mcp-server/tools/general-guidance.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGeneralGuidanceTool = exports.TOOL_SELECTION_GUIDE = void 0;
+const tslib_1 = require("tslib");
+const schema_1 = require("../schema");
+const generator_info_1 = require("../generator-info");
+exports.TOOL_SELECTION_GUIDE = `## Tool Selection Guide
+
+- Use the \`general-guidance\` tool for guidance and best practices for working with Nx and the Nx Plugin for AWS.
+- Use the \`create-workspace-command\` tool to discover how to create a workspace to start a new project.
+- Use the \`list-generators\` tool to discover the available generators and how to run them.
+- Use the \`generator-guide\` tool to retrieve detailed information about a specific generator.`;
+/**
+ * Add a tool which provides general guidance for using Nx and the Nx Plugin for AWS
+ */
+const addGeneralGuidanceTool = (server, generators) => {
+    server.tool('general-guidance', () => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+        return ({
+            content: [
+                {
+                    type: 'text',
+                    text: `# Nx Plugin for AWS Guidance
+
+${exports.TOOL_SELECTION_GUIDE}
+
+## Getting Started
+
+- Choose a package manager first. You can choose between ${schema_1.PACKAGE_MANAGERS.join(' ,')}. It's recommended to use "pnpm" if the user has no preference
+- Next, you must create an Nx workspace. Use the \`create-workspace-command\` tool for more details, and provide it with your chosen package manager
+- After this, you can start scaffolding the main components of your application using generators. Use the \`list-generators\` tool to discover available generators, and the \`generator-guide\` tool for more detailed information about a specific generator
+
+## Nx Primer
+
+- Prefix nx commands with the appropriate prefix for your package manager, for example:
+${schema_1.PACKAGE_MANAGERS.map((pm) => (0, generator_info_1.buildNxCommand)('<options>', pm)).join(' - \n')}
+- Each project in your workspace has a file named \`project.json\` which contains important project information such as its name, and defines the "targets" which can be run for that project, for example building or testing the project
+- Use the command \`nx reset\` to reset the Nx daemon when unexpected issues arise
+- After adding dependencies between projects, use \`nx sync\` to ensure project references are set up correctly
+
+## General Instructions
+
+- Workspaces contain a single \`package.json\` file at the root which defines the dependencies for all projects. Therefore when installing dependencies, you must add these to the root workspace using the appropriate command for your package manager:
+  - pnpm add -w -D <package>
+  - yarn add -D <package>
+  - npm install --legacy-peer-deps -D <package>
+  - bun install -D <package>
+  - (Omit -D for production dependencies)
+- When specifying project names as arguments to generators, use the _fully qualified_ project name, for example \`@workspace-name/project-name\`. Check the \`project.json\` file for the specific package to find its fully qualified name
+- When no generator exists for a specific framework required, use the base \`ts#project\` and \`py#project\` generators and build on top, unless building a React website in which case use the \`ts#cloudscape-website\` generator and replace CloudScape with your desired UI component library
+
+## Useful Commands
+
+- Fix lint issues with \`nx run-many --target lint --configuration=fix --all --output-style=stream\`
+- Build all projects with \`nx run-many --target build --all --output-style=stream\`
+
+## Best Practices
+
+- Generate all projects into the \`packages/\` directory
+- After making changes to your projects, fix linting issues, then run a full build
+
+## Language Specific Guidance
+
+Please refer to the below documentation for important details regarding working with any TypeScript or Python projects.
+
+${yield (0, generator_info_1.fetchGuidePages)(['typescript-project', 'python-project'], generators)}
+
+    `,
+                },
+            ],
+        });
+    }));
+};
+exports.addGeneralGuidanceTool = addGeneralGuidanceTool;
+//# sourceMappingURL=general-guidance.js.map

package/src/mcp-server/tools/general-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"general-guidance.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/general-guidance.ts"],"names":[],"mappings":";;;;AAMA,sCAA6C;AAC7C,sDAAoE;AAEvD,QAAA,oBAAoB,GAAG;;;;;gGAK4D,CAAC;AAEjG;;GAEG;AACI,MAAM,sBAAsB,GAAG,CACpC,MAAiB,EACjB,UAA6B,EAC7B,EAAE;IACF,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAS,EAAE;QAAC,OAAA,CAAC;YAC3C,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;EAEZ,4BAAoB;;;;2DAIqC,yBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;EAOpF,yBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAA,+BAAc,EAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B3E,MAAM,IAAA,gCAAe,EAAC,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,EAAE,UAAU,CAAC;;KAExE;iBACE;aACF;SACF,CAAC,CAAA;MAAA,CAAC,CAAC;AACN,CAAC,CAAC;AAzDW,QAAA,sBAAsB,0BAyDjC"}

package/src/mcp-server/tools/generator-guide.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { NxGeneratorInfo } from '../../utils/nx';
+/**
+ * Add a tool which provides a detailed guide for an individual generator
+ */
+export declare const addGeneratorGuideTool: (server: McpServer, generators: NxGeneratorInfo[]) => void;

package/src/mcp-server/tools/generator-guide.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addGeneratorGuideTool = void 0;
+const tslib_1 = require("tslib");
+const zod_1 = require("zod");
+const generator_info_1 = require("../generator-info");
+const schema_1 = require("../schema");
+/**
+ * Add a tool which provides a detailed guide for an individual generator
+ */
+const addGeneratorGuideTool = (server, generators) => {
+    server.tool('generator-guide', {
+        packageManager: schema_1.PackageManagerSchema,
+        generator: zod_1.z.custom((v) => generators.map((g) => g.id).includes(v)),
+    }, (_a) => tslib_1.__awaiter(void 0, [_a], void 0, function* ({ packageManager, generator: generatorId }) {
+        const generator = generators.find((g) => g.id === generatorId);
+        if (!generator) {
+            throw new Error(`No generator found with id ${generatorId}. Available generators: ${generators.map((g) => g.id).join(' ,')}`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `## ${(0, generator_info_1.renderGeneratorInfo)(packageManager, generator)}
+
+# Guide
+
+${yield (0, generator_info_1.fetchGuidePagesForGenerator)(generator, generators, packageManager)}
+`,
+                },
+            ],
+        };
+    }));
+};
+exports.addGeneratorGuideTool = addGeneratorGuideTool;
+//# sourceMappingURL=generator-guide.js.map

package/src/mcp-server/tools/generator-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator-guide.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/generator-guide.ts"],"names":[],"mappings":";;;;AAMA,6BAAwB;AACxB,sDAG2B;AAC3B,sCAAiD;AAEjD;;GAEG;AACI,MAAM,qBAAqB,GAAG,CACnC,MAAiB,EACjB,UAA6B,EAC7B,EAAE;IACF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB;QACE,cAAc,EAAE,6BAAoB;QACpC,SAAS,EAAE,OAAC,CAAC,MAAM,CAAS,CAAC,CAAC,EAAE,EAAE,CAChC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CACxC;KACF,EACD,KAAmD,EAAE,oDAA9C,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE;QAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,8BAA8B,WAAW,2BAA2B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7G,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,IAAA,oCAAmB,EAAC,cAAc,EAAE,SAAS,CAAC;;;;EAIpE,MAAM,IAAA,4CAA2B,EAAC,SAAS,EAAE,UAAU,EAAE,cAAc,CAAC;CACzE;iBACU;aACF;SACF,CAAC;IACJ,CAAC,CAAA,CACF,CAAC;AACJ,CAAC,CAAC;AAnCW,QAAA,qBAAqB,yBAmChC"}

package/src/mcp-server/tools/list-generators.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { NxGeneratorInfo } from '../../utils/nx';
+/**
+ * Adds a tool which lists details about the available generators
+ */
+export declare const addListGeneratorsTool: (server: McpServer, generators: NxGeneratorInfo[]) => void;

package/src/mcp-server/tools/list-generators.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addListGeneratorsTool = void 0;
+const schema_1 = require("../schema");
+const generator_info_1 = require("../generator-info");
+/**
+ * Adds a tool which lists details about the available generators
+ */
+const addListGeneratorsTool = (server, generators) => {
+    server.tool('list-generators', { packageManager: schema_1.PackageManagerSchema }, ({ packageManager }) => ({
+        content: [
+            {
+                type: 'text',
+                text: `## Available Generators
+
+  ${generators.map((g) => `### ${(0, generator_info_1.renderGeneratorInfo)(packageManager, g)}`).join('\n\n')}
+  `,
+            },
+        ],
+    }));
+};
+exports.addListGeneratorsTool = addListGeneratorsTool;
+//# sourceMappingURL=list-generators.js.map

package/src/mcp-server/tools/list-generators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-generators.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/mcp-server/tools/list-generators.ts"],"names":[],"mappings":";;;AAKA,sCAAiD;AACjD,sDAAwD;AAGxD;;GAEG;AACI,MAAM,qBAAqB,GAAG,CACnC,MAAiB,EACjB,UAA6B,EAC7B,EAAE;IACF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,EAAE,cAAc,EAAE,6BAAoB,EAAE,EACxC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;;IAEZ,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,IAAA,oCAAmB,EAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;GACpF;aACM;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC,CAAC;AAnBW,QAAA,qBAAqB,yBAmBhC"}

package/src/py/project/generator.js

@@ -99,10 +99,14 @@ const pyProjectGenerator = (tree, schema) => tslib_1.__awaiter(void 0, void 0, v
     };
     projectConfiguration.targets = (0, object_1.sortObjectKeys)(projectConfiguration.targets);
     (0, devkit_1.updateProjectConfiguration)(tree, normalizedName, projectConfiguration);
-    // Update root .gitignore to ignore reports directory
+    // Update root .gitignore
     (0, git_1.updateGitIgnore)(tree, '.', (patterns) => [...patterns, '/reports']);
-    // Update project level .gitignore to ignore __pycache__ directories
-    (0, git_1.updateGitIgnore)(tree, dir, (patterns) => [...patterns, '**/__pycache__']);
+    // Update project level .gitignore
+    (0, git_1.updateGitIgnore)(tree, dir, (patterns) => [
+        ...patterns,
+        '**/__pycache__',
+        '.coverage',
+    ]);
     yield (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.PY_PROJECT_GENERATOR_INFO]);
     return () => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
         yield new provider_1.UVProvider(tree.root, new logger_1.Logger(), tree).install();

package/src/py/project/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/py/project/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/py/project/generator.ts"],"names":[],"mappings":"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"}

package/src/ts/nx-generator/__snapshots__/generator.spec.ts.snap

@@ -9,7 +9,6 @@ description: Some description
 import { FileTree } from '@astrojs/starlight/components';
 import RunGenerator from '@components/run-generator.astro';
 import GeneratorParameters from '@components/generator-parameters.astro';
-import schema from '../../../../../../packages/nx-plugin/src/foo-bar/schema.json';
 
 TODO: Add an overview of your generator here.
 
@@ -23,7 +22,7 @@ You can generate a foo#bar in two ways:
 
 ### Options
 
-<GeneratorParameters schema={schema} />
+<GeneratorParameters generator="foo#bar" />
 
 ## Generator Output
 

package/src/ts/nx-generator/files/nx-plugin-for-aws/docs/__nameKebabCase__.mdx.template

@@ -6,7 +6,6 @@ description: <%- description ?? 'TODO - A short description of your generator' %
 import { FileTree } from '@astrojs/starlight/components';
 import RunGenerator from '@components/run-generator.astro';
 import GeneratorParameters from '@components/generator-parameters.astro';
-import schema from '../../../../../../packages/nx-plugin/src/<%- generatorSubDir %>/schema.json';
 
 TODO: Add an overview of your generator here.
 
@@ -20,7 +19,7 @@ You can generate a <%- name %> in two ways:
 
 ### Options
 
-<GeneratorParameters schema={schema} />
+<GeneratorParameters generator="<%- name %>" />
 
 ## Generator Output
 

package/src/utils/nx.d.ts

@@ -2,7 +2,16 @@ export interface NxGeneratorInfo {
     readonly id: string;
     readonly metric: string;
     readonly resolvedFactoryPath: string;
+    readonly resolvedSchemaPath: string;
+    readonly hidden?: boolean;
+    readonly description: string;
+    readonly guidePages?: string[];
 }
+/**
+ * List Nx Plugin for AWS generators
+ * @param includeHidden include hidden generators (default false)
+ */
+export declare const listGenerators: (includeHidden?: boolean) => NxGeneratorInfo[];
 /**
  * Return generator information. Call this from a generator method with __filename
  */

package/src/utils/nx.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPackageVersion = exports.getGeneratorInfo = void 0;
+exports.getPackageVersion = exports.getGeneratorInfo = exports.listGenerators = void 0;
 const tslib_1 = require("tslib");
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
@@ -9,11 +9,21 @@ const tslib_1 = require("tslib");
 const generators_json_1 = tslib_1.__importDefault(require("../../generators.json"));
 const package_json_1 = tslib_1.__importDefault(require("../../package.json"));
 const path = tslib_1.__importStar(require("path"));
-const GENERATORS = Object.entries(generators_json_1.default.generators).map(([id, { metric, factory }]) => ({
-    id,
-    metric,
-    resolvedFactoryPath: path.resolve(__dirname, '..', '..', factory),
-}));
+const GENERATORS = Object.entries(generators_json_1.default.generators).map(([id, info]) => (Object.assign(Object.assign({ id, metric: info.metric, resolvedFactoryPath: path.resolve(__dirname, '..', '..', info.factory), resolvedSchemaPath: path.resolve(__dirname, '..', '..', info.schema), description: info.description }, ('hidden' in info && info.hidden
+    ? {
+        hidden: info.hidden,
+    }
+    : {})), ('guidePages' in info && info.guidePages
+    ? {
+        guidePages: info.guidePages,
+    }
+    : {}))));
+/**
+ * List Nx Plugin for AWS generators
+ * @param includeHidden include hidden generators (default false)
+ */
+const listGenerators = (includeHidden = false) => GENERATORS.filter((g) => includeHidden || !g.hidden);
+exports.listGenerators = listGenerators;
 /**
  * Return generator information. Call this from a generator method with __filename
  */

package/src/utils/nx.js.map

@@ -1 +1 @@
-{"version":3,"file":"nx.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/nx.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,oFAAmD;AACnD,8EAA6C;AAC7C,mDAA6B;AAQ7B,MAAM,UAAU,GAAsB,MAAM,CAAC,OAAO,CAClD,yBAAc,CAAC,UAAU,CAC1B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,EAAE;IACF,MAAM;IACN,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;CAClE,CAAC,CAAC,CAAC;AAEJ;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAC9B,iBAAyB,EACR,EAAE;IACnB,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAClE,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO,UAAU,CAAC,IAAI,CACpB,CAAC,aAAa,EAAE,EAAE,CAChB,aAAa,CAAC,mBAAmB,KAAK,mBAAmB,CAC5D,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,gBAAgB,oBAS3B;AAEK,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,OAAO,sBAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B"}
+{"version":3,"file":"nx.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/utils/nx.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,oFAAmD;AACnD,8EAA6C;AAC7C,mDAA6B;AAY7B,MAAM,UAAU,GAAsB,MAAM,CAAC,OAAO,CAClD,yBAAc,CAAC,UAAU,CAC1B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,+BACpB,EAAE,EACF,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EACtE,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EACpE,WAAW,EAAE,IAAI,CAAC,WAAW,IAC1B,CAAC,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM;IACjC,CAAC,CAAC;QACE,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB;IACH,CAAC,CAAC,EAAE,CAAC,GACJ,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU;IACzC,CAAC,CAAC;QACE,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B;IACH,CAAC,CAAC,EAAE,CAAC,EACP,CAAC,CAAC;AAEJ;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,aAAa,GAAG,KAAK,EAAqB,EAAE,CACzE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAD1C,QAAA,cAAc,kBAC4B;AAEvD;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAC9B,iBAAyB,EACR,EAAE;IACnB,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAClE,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO,UAAU,CAAC,IAAI,CACpB,CAAC,aAAa,EAAE,EAAE,CAChB,aAAa,CAAC,mBAAmB,KAAK,mBAAmB,CAC5D,CAAC;AACJ,CAAC,CAAC;AATW,QAAA,gBAAgB,oBAS3B;AAEK,MAAM,iBAAiB,GAAG,GAAG,EAAE;IACpC,OAAO,sBAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B"}

package/src/utils/versions.d.ts

@@ -13,7 +13,7 @@ export declare const VERSIONS: {
     readonly '@aws-lambda-powertools/tracer': "^2.17.0";
     readonly '@nxlv/python': "^21.0.0";
     readonly '@nx/devkit': "~21.0.3";
-    readonly '@modelcontextprotocol/sdk': "^1.10.2";
+    readonly '@modelcontextprotocol/sdk': "^1.11.3";
     readonly '@tanstack/react-router': "^1.114.27";
     readonly '@tanstack/router-plugin': "^1.114.27";
     readonly '@cloudscape-design/board-components': "^3.0.94";
@@ -46,5 +46,5 @@ export declare const VERSIONS: {
  * Add versions to the given dependencies
  */
 export declare const withVersions: (deps: (keyof typeof VERSIONS)[]) => {
-    [k: string]: "^0.0.60" | "^2.185.0-alpha.0" | "^3.775.0" | "^2.17.0" | "^21.0.0" | "~21.0.3" | "^1.10.2" | "^1.114.27" | "^3.0.94" | "^3.0.928" | "^1.0.38" | "^5.74.3" | "11.0.0" | "^22.13.13" | "^8.10.148" | "^4.2.0" | "^1.0.20" | "^2.1006.0" | "^2.185.0" | "^3.10.3" | "^10.4.2" | "^0.25.1" | "^5.2.5" | "^2.4.0" | "^3.2.0" | "^3.5.3" | "^0.5.21" | "^4.19.3" | "^5.1.4" | "^3.24.2";
+    [k: string]: "^0.0.60" | "^2.185.0-alpha.0" | "^3.775.0" | "^2.17.0" | "^21.0.0" | "~21.0.3" | "^1.11.3" | "^1.114.27" | "^3.0.94" | "^3.0.928" | "^1.0.38" | "^5.74.3" | "11.0.0" | "^22.13.13" | "^8.10.148" | "^4.2.0" | "^1.0.20" | "^2.1006.0" | "^2.185.0" | "^3.10.3" | "^10.4.2" | "^0.25.1" | "^5.2.5" | "^2.4.0" | "^3.2.0" | "^3.5.3" | "^0.5.21" | "^4.19.3" | "^5.1.4" | "^3.24.2";
 };

package/src/utils/versions.js

@@ -16,7 +16,7 @@ exports.VERSIONS = {
     '@aws-lambda-powertools/tracer': '^2.17.0',
     '@nxlv/python': '^21.0.0',
     '@nx/devkit': '~21.0.3',
-    '@modelcontextprotocol/sdk': '^1.10.2',
+    '@modelcontextprotocol/sdk': '^1.11.3',
     '@tanstack/react-router': '^1.114.27',
     '@tanstack/router-plugin': '^1.114.27',
     '@cloudscape-design/board-components': '^3.0.94',