@aws/nx-plugin-mcp 0.96.0

package/generators.json

@@ -0,0 +1,246 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "name": "@aws/nx-plugin",
+  "version": "0.0.1",
+  "generators": {
+    "connection": {
+      "factory": "./src/connection/generator",
+      "schema": "./src/connection/schema.json",
+      "description": "Integrates a source project with a target project",
+      "metric": "g11",
+      "guidePages": [
+        "connection",
+        "connection/react-fastapi",
+        "connection/react-trpc",
+        "connection/react-smithy",
+        "connection/react-ts-strands-agent",
+        "connection/react-py-strands-agent",
+        "connection/py-strands-agent-mcp",
+        "connection/ts-strands-agent-mcp"
+      ]
+    },
+    "license": {
+      "factory": "./src/license/generator",
+      "schema": "./src/license/schema.json",
+      "description": "Add LICENSE files and configure source code licence headers",
+      "metric": "g14"
+    },
+    "license#sync": {
+      "factory": "./src/license/sync/generator",
+      "schema": "./src/license/sync/schema.json",
+      "description": "Sync generator for writing licence headers and subproject LICENSE files",
+      "metric": "g15",
+      "hidden": true
+    },
+    "open-api#ts-client": {
+      "factory": "./src/open-api/ts-client/generator",
+      "schema": "./src/open-api/ts-client/schema.json",
+      "description": "Generate a typescript client from an OpenAPI specification",
+      "metric": "g12",
+      "hidden": true
+    },
+    "open-api#ts-hooks": {
+      "factory": "./src/open-api/ts-hooks/generator",
+      "schema": "./src/open-api/ts-hooks/schema.json",
+      "description": "Generate typescript hooks from an OpenAPI specification",
+      "metric": "g13",
+      "hidden": true
+    },
+    "open-api#ts-metadata": {
+      "factory": "./src/open-api/ts-metadata/generator",
+      "schema": "./src/open-api/ts-metadata/schema.json",
+      "description": "Generate typescript metadata from an OpenAPI specification",
+      "metric": "g19",
+      "hidden": true
+    },
+    "preset": {
+      "factory": "./src/preset/generator",
+      "schema": "./src/preset/schema.json",
+      "description": "The @aws/nx-plugin workspace preset.",
+      "metric": "g20",
+      "hidden": true
+    },
+    "py#fast-api": {
+      "factory": "./src/py/fast-api/generator",
+      "schema": "./src/py/fast-api/schema.json",
+      "description": "Generates a FastAPI Python project",
+      "metric": "g3",
+      "guidePages": ["fastapi"]
+    },
+    "py#fast-api#react-connection": {
+      "factory": "./src/py/fast-api/react/generator",
+      "schema": "./src/py/fast-api/react/schema.json",
+      "description": "Integrates a FastAPI with a React website",
+      "metric": "g4",
+      "hidden": true
+    },
+    "py#lambda-function": {
+      "factory": "./src/py/lambda-function/generator",
+      "schema": "./src/py/lambda-function/schema.json",
+      "description": "Adds a lambda function to a python project",
+      "metric": "g16",
+      "guidePages": ["python-lambda-function"]
+    },
+    "py#mcp-server": {
+      "factory": "./src/py/mcp-server/generator",
+      "schema": "./src/py/mcp-server/schema.json",
+      "description": "Generate a Python Model Context Protocol (MCP) server for providing context to Large Language Models",
+      "metric": "g24"
+    },
+    "py#project": {
+      "factory": "./src/py/project/generator",
+      "schema": "./src/py/project/schema.json",
+      "description": "Generates a Python project",
+      "metric": "g2",
+      "guidePages": ["python-project"]
+    },
+    "py#strands-agent": {
+      "factory": "./src/py/strands-agent/generator",
+      "schema": "./src/py/strands-agent/schema.json",
+      "description": "Add a Strands Agent to a Python project",
+      "metric": "g25"
+    },
+    "smithy#project": {
+      "factory": "./src/smithy/project/generator",
+      "schema": "./src/smithy/project/schema.json",
+      "description": "Generate a Smithy model project",
+      "metric": "g27",
+      "hidden": true
+    },
+    "smithy#react-connection": {
+      "factory": "./src/smithy/react-connection/generator",
+      "schema": "./src/smithy/react-connection/schema.json",
+      "description": "Connects a react website to a Smithy API",
+      "metric": "g28",
+      "hidden": true
+    },
+    "terraform#project": {
+      "factory": "./src/terraform/project/generator",
+      "schema": "./src/terraform/project/schema.json",
+      "description": "Generates a Terraform project",
+      "metric": "g23",
+      "guidePages": ["terraform-project"]
+    },
+    "ts#infra": {
+      "factory": "./src/infra/app/generator",
+      "schema": "./src/infra/app/schema.json",
+      "description": "Generates a cdk application",
+      "metric": "g8",
+      "guidePages": ["typescript-infrastructure"]
+    },
+    "ts#lambda-function": {
+      "factory": "./src/ts/lambda-function/generator",
+      "schema": "./src/ts/lambda-function/schema.json",
+      "description": "Generate a TypeScript lambda function",
+      "metric": "g21"
+    },
+    "ts#mcp-server": {
+      "factory": "./src/ts/mcp-server/generator",
+      "schema": "./src/ts/mcp-server/schema.json",
+      "description": "Generate a TypeScript Model Context Protocol (MCP) server for providing context to Large Language Models",
+      "metric": "g18"
+    },
+    "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",
+      "guidePages": ["nx-generator"]
+    },
+    "ts#nx-plugin": {
+      "factory": "./src/ts/nx-plugin/generator",
+      "schema": "./src/ts/nx-plugin/schema.json",
+      "description": "Generate an Nx Plugin of your own! Build custom generators automatically made available for AI vibe-coding via MCP",
+      "metric": "g22"
+    },
+    "ts#project": {
+      "factory": "./src/ts/lib/generator",
+      "schema": "./src/ts/lib/schema.json",
+      "description": "Generates a TypeScript project",
+      "metric": "g1",
+      "guidePages": ["typescript-project"]
+    },
+    "ts#react-website": {
+      "factory": "./src/ts/react-website/app/generator",
+      "schema": "./src/ts/react-website/app/schema.json",
+      "description": "Generates a React static website",
+      "metric": "g5",
+      "guidePages": ["react-website"]
+    },
+    "ts#react-website#auth": {
+      "factory": "./src/ts/react-website/cognito-auth/generator",
+      "schema": "./src/ts/react-website/cognito-auth/schema.json",
+      "description": "Adds auth to an existing React website",
+      "metric": "g6",
+      "guidePages": ["react-website-auth"]
+    },
+    "ts#react-website#runtime-config": {
+      "factory": "./src/ts/react-website/runtime-config/generator",
+      "schema": "./src/ts/react-website/runtime-config/schema.json",
+      "description": "Adds runtime config to an existing React website",
+      "metric": "g7",
+      "hidden": true
+    },
+    "ts#smithy-api": {
+      "factory": "./src/smithy/ts/api/generator",
+      "schema": "./src/smithy/ts/api/schema.json",
+      "description": "Create an API using Smithy and the Smithy TypeScript Server SDK",
+      "metric": "g26"
+    },
+    "ts#strands-agent": {
+      "factory": "./src/ts/strands-agent/generator",
+      "schema": "./src/ts/strands-agent/schema.json",
+      "description": "Add a Strands Agent to a TypeScript project",
+      "metric": "g30"
+    },
+    "ts#strands-agent#react-connection": {
+      "factory": "./src/ts/strands-agent/react-connection/generator",
+      "schema": "./src/ts/strands-agent/react-connection/schema.json",
+      "description": "Connect a React website to a TypeScript Strands Agent",
+      "metric": "g33",
+      "hidden": true
+    },
+    "ts#strands-agent#mcp-connection": {
+      "factory": "./src/ts/strands-agent/mcp-connection/generator",
+      "schema": "./src/ts/strands-agent/mcp-connection/schema.json",
+      "description": "Connect a TypeScript Strands Agent to an MCP server",
+      "metric": "g31",
+      "hidden": true
+    },
+    "py#strands-agent#mcp-connection": {
+      "factory": "./src/py/strands-agent/mcp-connection/generator",
+      "schema": "./src/py/strands-agent/mcp-connection/schema.json",
+      "description": "Connect a Python Strands Agent to an MCP server",
+      "metric": "g32",
+      "hidden": true
+    },
+    "py#strands-agent#react-connection": {
+      "factory": "./src/py/strands-agent/react-connection/generator",
+      "schema": "./src/py/strands-agent/react-connection/schema.json",
+      "description": "Connect a React website to a Python Strands Agent",
+      "metric": "g34",
+      "hidden": true
+    },
+    "ts#sync": {
+      "factory": "./src/ts/sync/generator",
+      "schema": "./src/ts/sync/schema.json",
+      "description": "TypeScript path alias sync generator",
+      "metric": "g29",
+      "hidden": true
+    },
+    "ts#trpc-api": {
+      "factory": "./src/trpc/backend/generator",
+      "schema": "./src/trpc/backend/schema.json",
+      "description": "creates a trpc backend",
+      "metric": "g9",
+      "guidePages": ["trpc"]
+    },
+    "ts#trpc-api#react-connection": {
+      "factory": "./src/trpc/react/generator",
+      "schema": "./src/trpc/react/schema.json",
+      "description": "provides React integration to a React website",
+      "metric": "g10",
+      "hidden": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@aws/nx-plugin-mcp",
+  "version": "0.96.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/awslabs/nx-plugin-for-aws.git",
+    "directory": "packages/nx-plugin-mcp"
+  },
+  "private": false,
+  "type": "commonjs",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "aws-nx-mcp": "./bin/aws-nx-mcp.cjs"
+  }
+}

package/src/connection/schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "Connection",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "sourceProject": {
+      "type": "string",
+      "description": "The source project",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "Select the source project",
+      "x-dropdown": "projects"
+    },
+    "targetProject": {
+      "type": "string",
+      "description": "The target project to connect to",
+      "x-prompt": "Select the target project to connect to",
+      "x-dropdown": "projects"
+    },
+    "sourceComponent": {
+      "type": "string",
+      "description": "The source component to connect from (component name, path relative to source project root, or generator id). Use '.' to explicitly select the project as the source."
+    },
+    "targetComponent": {
+      "type": "string",
+      "description": "The target component to connect to (component name, path relative to target project root, or generator id). Use '.' to explicitly select the project as the target."
+    }
+  },
+  "required": ["sourceProject", "targetProject"]
+}

package/src/infra/app/schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "Infra",
+  "title": "",
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "The name of the application.",
+      "type": "string",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the application?",
+      "pattern": "^[a-zA-Z][^:]*$"
+    },
+    "directory": {
+      "description": "The directory of the new application.",
+      "type": "string",
+      "alias": "dir",
+      "x-priority": "important",
+      "default": "packages",
+      "x-prompt": "What directory would you like to store your application in?"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. By default this is the project name.",
+      "x-prompt": "Which sub directory do you want to create the project in? (By default this is the project name)"
+    },
+    "enableStageConfig": {
+      "description": "Enable centralized stage configuration (credentials, account, region) for multi-environment CDK deployments.",
+      "type": "boolean",
+      "default": false,
+      "x-prompt": "Would you like to enable centralized stage credential configuration?"
+    }
+  },
+  "required": ["name"]
+}

package/src/license/schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "License",
+  "title": "Add LICENSE files, and configure source code license headers",
+  "type": "object",
+  "properties": {
+    "license": {
+      "type": "string",
+      "description": "SPDX License Identifier for your chosen license",
+      "enum": ["Apache-2.0", "MIT", "ASL"],
+      "default": "Apache-2.0",
+      "x-priority": "important"
+    },
+    "copyrightHolder": {
+      "type": "string",
+      "description": "The copyright holder, included in the LICENSE file and source file headers by default.",
+      "default": "Amazon.com, Inc. or its affiliates",
+      "x-priority": "important"
+    }
+  },
+  "required": []
+}

package/src/license/sync/schema.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "license-headers",
+  "title": "Sync generator for adding license headers to source code",
+  "type": "object",
+  "properties": {},
+  "required": []
+}

package/src/open-api/ts-client/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "OpenApiTsClient",
+  "title": "OpenAPI TypeScript Client",
+  "description": "Generate TypeScript client from an OpenAPI specification",
+  "type": "object",
+  "properties": {
+    "openApiSpecPath": {
+      "type": "string",
+      "description": "Path to the OpenAPI specification relative to the monorepo root",
+      "x-priority": "important"
+    },
+    "outputPath": {
+      "type": "string",
+      "description": "Path to the directory in which to generate the client relative to the monorepo root",
+      "x-priority": "important"
+    }
+  },
+  "required": ["openApiSpecPath", "outputPath"]
+}

package/src/open-api/ts-hooks/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "OpenApiTsHooks",
+  "title": "OpenAPI TypeScript Hooks",
+  "description": "Generate TypeScript hooks from an OpenAPI specification",
+  "type": "object",
+  "properties": {
+    "openApiSpecPath": {
+      "type": "string",
+      "description": "Path to the OpenAPI specification relative to the monorepo root",
+      "x-priority": "important"
+    },
+    "outputPath": {
+      "type": "string",
+      "description": "Path to the directory in which to generate the hooks relative to the monorepo root",
+      "x-priority": "important"
+    }
+  },
+  "required": ["openApiSpecPath", "outputPath"]
+}

package/src/open-api/ts-metadata/schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "OpenApiTsMetadata",
+  "title": "OpenAPI TypeScript Metadata",
+  "description": "Generate TypeScript metadata from an OpenAPI specification",
+  "type": "object",
+  "properties": {
+    "openApiSpecPath": {
+      "type": "string",
+      "description": "Path to the OpenAPI specification relative to the monorepo root",
+      "x-priority": "important"
+    },
+    "outputPath": {
+      "type": "string",
+      "description": "Path to the directory in which to generate the metadata relative to the monorepo root",
+      "x-priority": "important"
+    }
+  },
+  "required": ["openApiSpecPath", "outputPath"]
+}

package/src/preset/schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "preset",
+  "title": "preset",
+  "description": "The @aws/nx-plugin preset.",
+  "type": "object",
+  "properties": {
+    "addTsPlugin": {
+      "type": "boolean",
+      "description": "Whether to add the ts plugin.",
+      "default": true
+    },
+    "iacProvider": {
+      "type": "string",
+      "description": "The preferred IaC provider.",
+      "enum": ["CDK", "Terraform"],
+      "x-priority": "important",
+      "x-prompt": "Which provider would you like to manage your infrastructure?"
+    }
+  },
+  "required": ["iacProvider"]
+}

package/src/py/fast-api/react/schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "FastAPIReact",
+  "title": "Integrate a Python FastAPI with a react website",
+  "description": "Integrate a Python FastAPI with a react website",
+  "type": "object",
+  "properties": {
+    "frontendProjectName": {
+      "type": "string",
+      "description": "",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "React application's project name.",
+      "x-dropdown": "projects"
+    },
+    "fastApiProjectName": {
+      "type": "string",
+      "description": "",
+      "x-prompt": "Package containing your FastAPI backend",
+      "x-dropdown": "projects"
+    }
+  },
+  "required": ["frontendProjectName", "fastApiProjectName"]
+}

package/src/py/fast-api/schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "PyFastApi",
+  "title": "Create a Python FastAPI project",
+  "description": "Create a Python FastAPI project",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Name of the API project to generate",
+      "x-priority": "important",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like your API to have? i.e: MyApi"
+    },
+    "computeType": {
+      "type": "string",
+      "description": "The type of compute to use to deploy this API. Choose between ServerlessApiGatewayRestApi (default) or ServerlessApiGatewayHttpApi.",
+      "default": "ServerlessApiGatewayRestApi",
+      "enum": ["ServerlessApiGatewayRestApi", "ServerlessApiGatewayHttpApi"],
+      "x-prompt": "What compute type would you like to deploy your API with?",
+      "x-priority": "important"
+    },
+    "integrationPattern": {
+      "type": "string",
+      "description": "How API Gateway integrations are generated for the API. Choose between isolated (default) and shared.",
+      "default": "isolated",
+      "enum": ["isolated", "shared"],
+      "x-priority": "important",
+      "x-prompt": {
+        "message": "How would you like to map integrations to your FastAPI operations?",
+        "type": "list",
+        "items": [
+          {
+            "value": "isolated",
+            "label": "isolated (one integration per operation)"
+          },
+          {
+            "value": "shared",
+            "label": "shared (single default integration with optional overrides)"
+          }
+        ],
+        "default": "isolated"
+      }
+    },
+    "auth": {
+      "type": "string",
+      "description": "The method used to authenticate with your API. Choose between IAM (default), Cognito or None.",
+      "default": "IAM",
+      "enum": ["IAM", "Cognito", "None"],
+      "x-prompt": "How would you like users to authenticate with your API?",
+      "x-priority": "important"
+    },
+    "directory": {
+      "type": "string",
+      "description": "The directory to store the application in.",
+      "default": "packages",
+      "x-prompt": "Which directory do you want to create the project in?",
+      "x-priority": "important"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. By default this is the project name.",
+      "x-prompt": "Which sub directory do you want to create the project in? (By default this is the project name)"
+    },
+    "iacProvider": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["Inherit", "CDK", "Terraform"],
+      "x-priority": "important",
+      "default": "Inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: Inherit)"
+    },
+    "moduleName": {
+      "type": "string",
+      "description": "Python module name"
+    }
+  },
+  "required": ["name"]
+}

package/src/py/lambda-function/schema.json

@@ -0,0 +1,88 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "PyLambdaFunction",
+  "title": "Add a Python Lambda Function to a project",
+  "description": "Add a Python Lambda Function to a project",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The project to add the lambda function to",
+      "x-prompt": "Select the project to add the lambda function to",
+      "x-dropdown": "projects"
+    },
+    "functionName": {
+      "type": "string",
+      "description": "The name of the function to add",
+      "x-priority": "important",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like your Lambda Function to have? i.e: MyFunction"
+    },
+    "functionPath": {
+      "type": "string",
+      "description": "The path within the project source directory to add the function to",
+      "x-prompt": "Enter the path within the project source directory to add the function to (e.g. 'lambda_functions/')"
+    },
+    "eventSource": {
+      "type": "string",
+      "description": "Optional event source model to use for the lambda function",
+      "x-priority": "important",
+      "enum": [
+        "Any",
+        "AlbModel",
+        "APIGatewayProxyEventModel",
+        "ApiGatewayAuthorizerToken",
+        "ApiGatewayAuthorizerRequest",
+        "APIGatewayProxyEventV2Model",
+        "ApiGatewayAuthorizerRequestV2",
+        "APIGatewayWebSocketMessageEventModel",
+        "APIGatewayWebSocketConnectEventModel",
+        "APIGatewayWebSocketDisconnectEventModel",
+        "BedrockAgentEventModel",
+        "CloudFormationCustomResourceCreateModel",
+        "CloudFormationCustomResourceUpdateModel",
+        "CloudFormationCustomResourceDeleteModel",
+        "CloudwatchLogsModel",
+        "DynamoDBStreamModel",
+        "EventBridgeModel",
+        "IoTCoreThingEvent",
+        "IoTCoreThingTypeEvent",
+        "IoTCoreThingTypeAssociationEvent",
+        "IoTCoreThingGroupEvent",
+        "IoTCoreAddOrRemoveFromThingGroupEvent",
+        "IoTCoreAddOrDeleteFromThingGroupEvent",
+        "KafkaMskEventModel",
+        "KafkaSelfManagedEventModel",
+        "KinesisDataStreamModel",
+        "KinesisFirehoseModel",
+        "KinesisFirehoseSqsModel",
+        "LambdaFunctionUrlModel",
+        "S3BatchOperationModel",
+        "S3EventNotificationEventBridgeModel",
+        "S3Model",
+        "S3ObjectLambdaEvent",
+        "S3SqsEventNotificationModel",
+        "SesModel",
+        "SnsModel",
+        "SqsModel",
+        "TransferFamilyAuthorizer",
+        "VpcLatticeModel",
+        "VpcLatticeV2Model"
+      ],
+      "default": "Any",
+      "x-prompt": "Enter the event source model to use for the lambda function"
+    },
+    "iacProvider": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["Inherit", "CDK", "Terraform"],
+      "x-priority": "important",
+      "default": "Inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: Inherit)"
+    }
+  },
+  "required": ["project", "functionName"]
+}