@aws/nx-plugin 0.18.2 → 0.19.0

package/README.md

@@ -56,6 +56,8 @@
 - `ts#cloudscape-website` - Generate a new Cloudscape/React/Vite based web application.
 - `ts#cloudscape-website#auth` - Add AWS Cognito authentication to your Cloudscape website.
 - `ts#trpc-api` - Generate a tRPC backend service with Amazon API Gateway/AWS Lambda integration and [AWS Powertools](https://github.com/aws-powertools/powertools-lambda-typescript) pre-configured.
+- `ts#nx-generator` - Add an [Nx Generator](https://nx.dev/features/generate-code) to a TypeScript project.
+- `ts#mcp-server` - Generate a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server in TypeScript.
 - `py#project` - Generate a uv based Python project.
 - `py#fast-api` - Generate a FastAPI backend service with [AWS Powertools](https://github.com/aws-powertools/powertools-lambda-python) pre-configured.
 - `py#lambda-function` - Add a lambda function to an existing python project with optional type-safe event sources.

package/generators.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/schema",
-  "name": "pace",
+  "name": "@aws/nx-plugin",
   "version": "0.0.1",
   "generators": {
     "ts#project": {
@@ -104,6 +104,18 @@
       "schema": "./src/py/lambda-function/schema.json",
       "description": "Adds a lambda function to a python project",
       "metric": "g16"
+    },
+    "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"
+    },
+    "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"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws/nx-plugin",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",

package/src/open-api/ts-hooks/__snapshots__/generator.spec.tsx.snap

@@ -98,9 +98,7 @@ export class TestApiOptionsProxy {
       ...options,
     };
   }
-  private _getTestQueryFilter(
-    filter?: QueryFilters<GetTest200Response, GetTestError>,
-  ): QueryFilters<GetTest200Response, GetTestError> {
+  private _getTestQueryFilter(filter?: QueryFilters): QueryFilters {
     return {
       queryKey: this._getTestQueryKey(),
       ...filter,
@@ -173,8 +171,8 @@ export class TestApiOptionsProxy {
   }
   private _getItemsQueryFilter(
     input: GetItemsRequest,
-    filter?: QueryFilters<GetItems200Response, GetItemsError>,
-  ): QueryFilters<GetItems200Response, GetItemsError> {
+    filter?: QueryFilters,
+  ): QueryFilters {
     return {
       queryKey: this._getItemsQueryKey(input),
       ...filter,
@@ -338,8 +336,8 @@ export class TestApiOptionsProxy {
   }
   private _searchDataQueryFilter(
     input: SearchDataRequest,
-    filter?: QueryFilters<SearchData200Response, SearchDataError>,
-  ): QueryFilters<SearchData200Response, SearchDataError> {
+    filter?: QueryFilters,
+  ): QueryFilters {
     return {
       queryKey: this._searchDataQueryKey(input),
       ...filter,
@@ -412,8 +410,8 @@ export class TestApiOptionsProxy {
   }
   private _getItemsQueryFilter(
     input: GetItemsRequest,
-    filter?: QueryFilters<GetItems200Response, GetItemsError>,
-  ): QueryFilters<GetItems200Response, GetItemsError> {
+    filter?: QueryFilters,
+  ): QueryFilters {
     return {
       queryKey: this._getItemsQueryKey(input),
       ...filter,
@@ -529,8 +527,8 @@ export class TestApiOptionsProxy {
   }
   private _listRecordsQueryFilter(
     input: ListRecordsRequest,
-    filter?: QueryFilters<ListRecords200Response, ListRecordsError>,
-  ): QueryFilters<ListRecords200Response, ListRecordsError> {
+    filter?: QueryFilters,
+  ): QueryFilters {
     return {
       queryKey: this._listRecordsQueryKey(input),
       ...filter,
@@ -687,9 +685,7 @@ export class TestApiOptionsProxy {
       ...options,
     };
   }
-  private _getErrorQueryFilter(
-    filter?: QueryFilters<GetError200Response, GetErrorError>,
-  ): QueryFilters<GetError200Response, GetErrorError> {
+  private _getErrorQueryFilter(filter?: QueryFilters): QueryFilters {
     return {
       queryKey: this._getErrorQueryKey(),
       ...filter,
@@ -809,8 +805,8 @@ export class TestApiOptionsProxy {
   }
   private _streamLogsQueryFilter(
     input: StreamLogsRequest,
-    filter?: QueryFilters<StreamLogs200Response[], StreamLogsError>,
-  ): QueryFilters<StreamLogs200Response[], StreamLogsError> {
+    filter?: QueryFilters,
+  ): QueryFilters {
     return {
       queryKey: this._streamLogsQueryKey(input),
       ...filter,
@@ -1074,8 +1070,8 @@ export class TestApiOptionsProxy {
   }
   private _streamEventsQueryFilter(
     input: StreamEventsRequest,
-    filter?: QueryFilters<StreamEvents200Response[], StreamEventsError>,
-  ): QueryFilters<StreamEvents200Response[], StreamEventsError> {
+    filter?: QueryFilters,
+  ): QueryFilters {
     return {
       queryKey: this._streamEventsQueryKey(input),
       ...filter,

package/src/open-api/ts-hooks/files/options-proxy.gen.ts.template

@@ -133,7 +133,7 @@ export class <%- className %>OptionsProxy {
       ...options,
     };
   }
-  private _<%- op.uniqueName %>QueryFilter(<%- input %><% if (op.parameters.length > 0) { %>, <% } %>filter?: QueryFilters<<%- queryResultType %>, <%- errorType %>>): QueryFilters<<%- queryResultType %>, <%- errorType %>> {
+  private _<%- op.uniqueName %>QueryFilter(<%- input %><% if (op.parameters.length > 0) { %>, <% } %>filter?: QueryFilters): QueryFilters {
     return {
       queryKey: this._<%- op.uniqueName %>QueryKey(<% if (op.parameters.length > 0) { %>input<% } %>),
       ...filter,

package/src/ts/lib/ts-project-utils.js

@@ -34,7 +34,6 @@ const configureTsProject = (tree, options) => {
                     // Add aliases which begin with colon (eg :foo/bar) to avoid sniping attacks
                     [(0, npm_scope_1.toScopeAlias)(options.fullyQualifiedName)]: [
                         (0, devkit_1.joinPathFragments)(options.dir, 'src', 'index.ts'),
-                        (0, devkit_1.joinPathFragments)('dist', options.dir, 'src', 'index.d.ts'),
                     ] }) }) }));
     });
     if (tree.exists('tsconfig.json')) {

package/src/ts/lib/ts-project-utils.js.map

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

package/src/ts/mcp-server/__snapshots__/generator.spec.ts.snap

@@ -0,0 +1,330 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`ts#mcp-server generator > should match snapshot > mcp-server-files 1`] = `
+{
+  "test-server/README.md": "# test-server
+
+This package defines a Model Context Protocol (MCP) Server in TypeScript.
+
+## What is MCP?
+
+The Model Context Protocol (MCP) is a standardized protocol for providing context to Large Language Models (LLMs). It allows AI assistants to access external tools and resources through a consistent interface.
+
+## Documentation
+
+- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
+- [MCP TypeScript SDK Documentation](https://github.com/modelcontextprotocol/sdk-typescript)
+
+## Developer Guide
+
+### Getting Started
+
+This MCP server is built using the MCP TypeScript SDK. Here's how to work with it:
+
+1. **Server Structure**: The main server code is in \`src/server.ts\`. This file defines the server, its tools, and resources.
+
+2. **Adding Tools**: Tools are functions that the LLM can call to perform actions. Add new tools using the \`server.tool()\` method:
+
+\`\`\`typescript
+server.tool(
+  'toolName',
+  { param1: z.string(), param2: z.number() }, // Input schema using Zod
+  async ({ param1, param2 }) => {
+    // Tool implementation
+    return {
+      content: [{ type: 'text', text: 'Result' }],
+    };
+  },
+);
+\`\`\`
+
+3. **Adding Resources**: Resources provide context to the LLM. You can add static resources from files or dynamic resources:
+
+\`\`\`typescript
+// Static resource from a file
+import resourceContent from './resources/my-resource.md';
+
+server.resource('resource-name', 'example://resource', async (uri) => ({
+  contents: [{ uri: uri.href, text: resourceContent }],
+}));
+
+// Dynamic resource
+server.resource('dynamic-resource', 'dynamic://resource', async (uri) => {
+  const data = await fetchSomeData();
+  return {
+    contents: [{ uri: uri.href, text: data }],
+  };
+});
+\`\`\`
+
+### Building the Server
+
+To build the server for use with AI assistants:
+
+\`\`\`bash
+nx run <project-name>:bundle
+\`\`\`
+
+This creates a bundled version of your server in \`dist/<project-path>/bundle/index.js\`.
+
+## Using with AI Assistants
+
+To use your MCP server with AI assistants, you need to build it first to create the bundle:
+
+\`\`\`bash
+nx run <project-name>:bundle
+\`\`\`
+
+### Configuration
+
+Most AI assistants (Amazon Q Developer CLI, Cline, Cursor, Claude Code, etc.) use a similar configuration approach. You'll need to create or update a configuration file with your MCP server details:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "test-server": {
+      "command": "node",
+      "args": ["/path/to/workspace/dist/test-server/bundle/index.js"],
+      "transportType": "stdio"
+    }
+  }
+}
+\`\`\`
+
+Replace \`/path/to/workspace/dist/test-server/bundle/index.js\` with the actual path to your bundled MCP server.
+
+Note that if you receive an error due to \`node\` missing (eg \`ENOENT node\`), you might need to specify the full path to \`node\` which you can obtain by running \`which node\`.
+
+### Development Mode
+
+During development, you can use the \`dev\` target to continuously rebuild the bundle whenever you make changes:
+
+\`\`\`bash
+nx run <project-name>:dev
+\`\`\`
+
+This will watch for changes in your project files and automatically rebuild the bundle.
+
+Whenever you've made changes, you'll need to restart the MCP server in your AI assistant to test it out. The exact process depends on the assistant, but generally:
+
+1. Find your MCP server in the assistant's settings or configuration
+2. Look for a "Restart" or "Reload" option
+",
+  "test-server/eslint.config.mjs": "import baseConfig from '../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs}',
+            '{projectRoot}/vite.config.{js,ts,mjs,mts}',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];
+",
+  "test-server/project.json": "{
+  "name": "@proj/test-server",
+  "$schema": "../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "test-server/src",
+  "projectType": "library",
+  "tags": [],
+  "targets": {
+    "build": {
+      "dependsOn": ["lint", "compile", "test", "bundle"]
+    },
+    "compile": {
+      "executor": "nx:run-commands",
+      "outputs": ["{workspaceRoot}/dist/test-server/tsc"],
+      "options": {
+        "command": "tsc --build tsconfig.lib.json",
+        "cwd": "{projectRoot}"
+      }
+    },
+    "test": {
+      "executor": "@nx/vite:test",
+      "outputs": ["{options.reportsDirectory}"],
+      "options": {
+        "reportsDirectory": "../coverage/test-server"
+      }
+    },
+    "bundle": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": [
+          "esbuild \\"test-server/src/index.ts\\" --bundle --platform=node --format=esm --loader:.md=text --outfile=dist/test-server/bundle/index.js"
+        ]
+      }
+    },
+    "dev": {
+      "executor": "nx:run-commands",
+      "options": {
+        "commands": [
+          "nx watch --projects=@proj/test-server --includeDependentProjects -- nx run @proj/test-server:bundle"
+        ]
+      }
+    }
+  }
+}
+",
+  "test-server/src/global.d.ts": "declare module '*.md' {
+  const content: string;
+  export default content;
+}
+",
+  "test-server/src/index.ts": "import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+
+// Start receiving messages on stdin and sending messages on stdout
+const transport = new StdioServerTransport();
+await createServer().connect(transport);
+",
+  "test-server/src/resources/example-context.md": "## Example Context
+
+This is some example context in a markdown file!
+",
+  "test-server/src/server.ts": "import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import exampleContext from './resources/example-context.md';
+
+/**
+ * Create the MCP Server
+ */
+export const createServer = () => {
+  const server = new McpServer({
+    name: 'test-server',
+    version: '1.0.0',
+  });
+
+  // Add an addition tool
+  server.tool('add', { a: z.number(), b: z.number() }, async ({ a, b }) => ({
+    content: [{ type: 'text', text: String(a + b) }],
+  }));
+
+  // Add a resource which provides context from a markdown file
+  server.resource('example-context', 'example://context', async (uri) => ({
+    contents: [{ uri: uri.href, text: exampleContext }],
+  }));
+
+  return server;
+};
+",
+  "test-server/tsconfig.json": "{
+  "extends": "../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ],
+  "nx": {
+    "addTypecheckTarget": false
+  },
+  "compilerOptions": {}
+}
+",
+  "test-server/tsconfig.lib.json": "{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "outDir": "../dist/test-server/tsc",
+    "tsBuildInfoFile": "../dist/test-server/tsc/tsconfig.lib.tsbuildinfo",
+    "emitDeclarationOnly": false,
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "references": [],
+  "exclude": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx"
+  ]
+}
+",
+  "test-server/tsconfig.spec.json": "{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./out-tsc/vitest",
+    "types": [
+      "vitest/globals",
+      "vitest/importMeta",
+      "vite/client",
+      "node",
+      "vitest"
+    ],
+    "module": "nodenext",
+    "moduleResolution": "nodenext"
+  },
+  "include": [
+    "vite.config.ts",
+    "vite.config.mts",
+    "vitest.config.ts",
+    "vitest.config.mts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.test.tsx",
+    "src/**/*.spec.tsx",
+    "src/**/*.test.js",
+    "src/**/*.spec.js",
+    "src/**/*.test.jsx",
+    "src/**/*.spec.jsx",
+    "src/**/*.d.ts"
+  ],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    }
+  ]
+}
+",
+  "test-server/vite.config.ts": "import { defineConfig } from 'vite';
+
+export default defineConfig(() => ({
+  root: __dirname,
+  cacheDir: '../node_modules/.vite/test-server',
+  plugins: [],
+  // Uncomment this if you are using workers.
+  // worker: {
+  //  plugins: [ nxViteTsPaths() ],
+  // },
+  test: {
+    watch: false,
+    globals: true,
+    environment: 'jsdom',
+    include: ['src/**/*.{test,spec}.{js,mjs,cjs,ts,mts,cts,jsx,tsx}'],
+    reporters: ['default'],
+    coverage: {
+      reportsDirectory: './test-output/vitest/coverage',
+      provider: 'v8' as const,
+    },
+    passWithNoTests: true,
+  },
+}));
+",
+}
+`;

package/src/ts/mcp-server/files/README.md.template

@@ -0,0 +1,108 @@
+# <%- name %>
+
+This package defines a Model Context Protocol (MCP) Server in TypeScript.
+
+## What is MCP?
+
+The Model Context Protocol (MCP) is a standardized protocol for providing context to Large Language Models (LLMs). It allows AI assistants to access external tools and resources through a consistent interface.
+
+## Documentation
+
+- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
+- [MCP TypeScript SDK Documentation](https://github.com/modelcontextprotocol/sdk-typescript)
+
+## Developer Guide
+
+### Getting Started
+
+This MCP server is built using the MCP TypeScript SDK. Here's how to work with it:
+
+1. **Server Structure**: The main server code is in `src/server.ts`. This file defines the server, its tools, and resources.
+
+2. **Adding Tools**: Tools are functions that the LLM can call to perform actions. Add new tools using the `server.tool()` method:
+
+```typescript
+server.tool("toolName",
+  { param1: z.string(), param2: z.number() }, // Input schema using Zod
+  async ({ param1, param2 }) => {
+    // Tool implementation
+    return {
+      content: [{ type: "text", text: "Result" }]
+    };
+  }
+);
+```
+
+3. **Adding Resources**: Resources provide context to the LLM. You can add static resources from files or dynamic resources:
+
+```typescript
+// Static resource from a file
+import resourceContent from './resources/my-resource.md';
+
+server.resource('resource-name', 'example://resource', async (uri) => ({
+  contents: [{ uri: uri.href, text: resourceContent }],
+}));
+
+// Dynamic resource
+server.resource('dynamic-resource', 'dynamic://resource', async (uri) => {
+  const data = await fetchSomeData();
+  return {
+    contents: [{ uri: uri.href, text: data }],
+  };
+});
+```
+
+### Building the Server
+
+To build the server for use with AI assistants:
+
+```bash
+nx run <project-name>:bundle
+```
+
+This creates a bundled version of your server in `dist/<project-path>/bundle/index.js`.
+
+## Using with AI Assistants
+
+To use your MCP server with AI assistants, you need to build it first to create the bundle:
+
+```bash
+nx run <project-name>:bundle
+```
+
+### Configuration
+
+Most AI assistants (Amazon Q Developer CLI, Cline, Cursor, Claude Code, etc.) use a similar configuration approach. You'll need to create or update a configuration file with your MCP server details:
+
+```json
+{
+  "mcpServers": {
+    "<%- name %>": {
+      "command": "node",
+      "args": [
+        "/path/to/workspace/dist/<%- dir %>/bundle/index.js"
+      ],
+      "transportType": "stdio"
+    }
+  }
+}
+```
+
+Replace `/path/to/workspace/dist/<%- dir %>/bundle/index.js` with the actual path to your bundled MCP server.
+
+Note that if you receive an error due to `node` missing (eg `ENOENT node`), you might need to specify the full path to `node` which you can obtain by running `which node`.
+
+### Development Mode
+
+During development, you can use the `dev` target to continuously rebuild the bundle whenever you make changes:
+
+```bash
+nx run <project-name>:dev
+```
+
+This will watch for changes in your project files and automatically rebuild the bundle.
+
+Whenever you've made changes, you'll need to restart the MCP server in your AI assistant to test it out. The exact process depends on the assistant, but generally:
+
+1. Find your MCP server in the assistant's settings or configuration
+2. Look for a "Restart" or "Reload" option

package/src/ts/mcp-server/files/src/global.d.ts.template

@@ -0,0 +1,4 @@
+declare module '*.md' {
+  const content: string;
+  export default content;
+}

package/src/ts/mcp-server/files/src/index.ts.template

@@ -0,0 +1,6 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from './server.js';
+
+// Start receiving messages on stdin and sending messages on stdout
+const transport = new StdioServerTransport();
+await createServer().connect(transport);

package/src/ts/mcp-server/files/src/resources/example-context.md

@@ -0,0 +1,3 @@
+## Example Context
+
+This is some example context in a markdown file!

package/src/ts/mcp-server/files/src/server.ts.template

@@ -0,0 +1,28 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import exampleContext from './resources/example-context.md';
+
+/**
+ * Create the MCP Server
+ */
+export const createServer = () => {
+  const server = new McpServer({
+    name: "<%- name %>",
+    version: "1.0.0"
+  });
+
+  // Add an addition tool
+  server.tool("add",
+    { a: z.number(), b: z.number() },
+    async ({ a, b }) => ({
+      content: [{ type: "text", text: String(a + b) }]
+    })
+  );
+
+  // Add a resource which provides context from a markdown file
+  server.resource('example-context', 'example://context', async (uri) => ({
+    contents: [{ uri: uri.href, text: exampleContext }],
+  }));
+
+  return server;
+};

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

@@ -0,0 +1,10 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import { TsMcpServerGeneratorSchema } from './schema';
+import { NxGeneratorInfo } from '../../utils/nx';
+export declare const TS_MCP_SERVER_GENERATOR_INFO: NxGeneratorInfo;
+export declare const tsMcpServerGenerator: (tree: Tree, options: TsMcpServerGeneratorSchema) => Promise<GeneratorCallback>;
+export default tsMcpServerGenerator;