@aws/nx-plugin 0.18.3 → 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.3",
+  "version": "0.19.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",

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;

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

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tsMcpServerGenerator = exports.TS_MCP_SERVER_GENERATOR_INFO = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const devkit_1 = require("@nx/devkit");
+const nx_1 = require("../../utils/nx");
+const metrics_1 = require("../../utils/metrics");
+const format_1 = require("../../utils/format");
+const generator_1 = tslib_1.__importStar(require("../lib/generator"));
+const versions_1 = require("../../utils/versions");
+exports.TS_MCP_SERVER_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
+const tsMcpServerGenerator = (tree, options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d;
+    // Generate a TypeScript library
+    yield (0, generator_1.default)(tree, options);
+    const { fullyQualifiedName } = (0, generator_1.getTsLibDetails)(tree, options);
+    const project = (0, devkit_1.readProjectConfiguration)(tree, fullyQualifiedName);
+    // Add dependencies
+    const deps = (0, versions_1.withVersions)(['@modelcontextprotocol/sdk', 'zod']);
+    const devDeps = (0, versions_1.withVersions)(['tsx', 'esbuild']);
+    (0, devkit_1.addDependenciesToPackageJson)(tree, deps, devDeps);
+    // Generate example server
+    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files'), project.root, {
+        name: options.name,
+        dir: project.root,
+    }, { overwriteStrategy: devkit_1.OverwriteStrategy.Overwrite });
+    // Add build targets
+    (0, devkit_1.updateProjectConfiguration)(tree, fullyQualifiedName, Object.assign(Object.assign({}, project), { targets: Object.assign(Object.assign({}, project === null || project === void 0 ? void 0 : project.targets), { 
+            // Bundle with esbuild
+            bundle: {
+                executor: 'nx:run-commands',
+                options: {
+                    commands: [
+                        `esbuild "${(0, devkit_1.joinPathFragments)(project.sourceRoot, 'index.ts')}" --bundle --platform=node --format=esm --loader:.md=text --outfile=${(0, devkit_1.joinPathFragments)('dist', project.root, 'bundle', 'index.js')}`,
+                    ],
+                },
+            }, 
+            // Dev task for bundling whenever changes are made
+            dev: {
+                executor: 'nx:run-commands',
+                options: {
+                    commands: [
+                        `nx watch --projects=${fullyQualifiedName} --includeDependentProjects -- nx run ${fullyQualifiedName}:bundle`,
+                    ],
+                },
+            }, 
+            // Ensure bundle runs as part of build
+            build: Object.assign(Object.assign({}, (_a = project === null || project === void 0 ? void 0 : project.targets) === null || _a === void 0 ? void 0 : _a.build), { dependsOn: [...((_d = (_c = (_b = project === null || project === void 0 ? void 0 : project.targets) === null || _b === void 0 ? void 0 : _b.build) === null || _c === void 0 ? void 0 : _c.dependsOn) !== null && _d !== void 0 ? _d : []), 'bundle'] }) }) }));
+    yield (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.TS_MCP_SERVER_GENERATOR_INFO]);
+    yield (0, format_1.formatFilesInSubtree)(tree);
+    return () => {
+        (0, devkit_1.installPackagesTask)(tree);
+    };
+});
+exports.tsMcpServerGenerator = tsMcpServerGenerator;
+exports.default = exports.tsMcpServerGenerator;
+//# sourceMappingURL=generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/ts/mcp-server/generator.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,uCAUoB;AAEpB,uCAAmE;AACnE,iDAAsE;AACtE,+CAA0D;AAC1D,sEAAmE;AACnE,mDAAoD;AAEvC,QAAA,4BAA4B,GACvC,IAAA,qBAAgB,EAAC,UAAU,CAAC,CAAC;AAExB,MAAM,oBAAoB,GAAG,CAClC,IAAU,EACV,OAAmC,EACP,EAAE;;IAC9B,gCAAgC;IAChC,MAAM,IAAA,mBAAc,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAA,2BAAe,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAA,iCAAwB,EAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAEnE,mBAAmB;IACnB,MAAM,IAAI,GAAG,IAAA,uBAAY,EAAC,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAA,uBAAY,EAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IACjD,IAAA,qCAA4B,EAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAElD,0BAA0B;IAC1B,IAAA,sBAAa,EACX,IAAI,EACJ,IAAA,0BAAiB,EAAC,SAAS,EAAE,OAAO,CAAC,EACrC,OAAO,CAAC,IAAI,EACZ;QACE,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,IAAI;KAClB,EACD,EAAE,iBAAiB,EAAE,0BAAiB,CAAC,SAAS,EAAE,CACnD,CAAC;IAEF,oBAAoB;IACpB,IAAA,mCAA0B,EAAC,IAAI,EAAE,kBAAkB,kCAC9C,OAAO,KACV,OAAO,kCACF,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO;YACnB,sBAAsB;YACtB,MAAM,EAAE;gBACN,QAAQ,EAAE,iBAAiB;gBAC3B,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR,YAAY,IAAA,0BAAiB,EAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,uEAAuE,IAAA,0BAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE;qBACpM;iBACF;aACF;YACD,kDAAkD;YAClD,GAAG,EAAE;gBACH,QAAQ,EAAE,iBAAiB;gBAC3B,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR,uBAAuB,kBAAkB,yCAAyC,kBAAkB,SAAS;qBAC9G;iBACF;aACF;YACD,sCAAsC;YACtC,KAAK,kCACA,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,0CAAE,KAAK,KAC1B,SAAS,EAAE,CAAC,GAAG,CAAC,MAAA,MAAA,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,0CAAE,KAAK,0CAAE,SAAS,mCAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,UAGxE,CAAC;IAEH,MAAM,IAAA,yCAA+B,EAAC,IAAI,EAAE,CAAC,oCAA4B,CAAC,CAAC,CAAC;IAE5E,MAAM,IAAA,6BAAoB,EAAC,IAAI,CAAC,CAAC;IACjC,OAAO,GAAG,EAAE;QACV,IAAA,4BAAmB,EAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC,CAAA,CAAC;AAhEW,QAAA,oBAAoB,wBAgE/B;AAEF,kBAAe,4BAAoB,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { TsLibGeneratorSchema } from '../lib/schema';
+
+/**
+ * TypeScript types for options defined in schema.json
+ * Update this to match schema.json if you make changes.
+ */
+export type TsMcpServerGeneratorSchema = TsLibGeneratorSchema;

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

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "ts#mcp-server",
+  "title": "ts#mcp-server",
+  "description": "Generate a TypeScript Model Context Protocol (MCP) server for providing context to Large Language Models",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "MCP server project name.",
+      "x-priority": "important"
+    },
+    "directory": {
+      "type": "string",
+      "description": "Parent directory where the MCP server is placed.",
+      "default": "packages",
+      "x-prompt": "Which directory do you want to create the MCP server in?",
+      "x-priority": "important"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the MCP server is placed in. By default this is the MCP server project name.",
+      "x-prompt": "Which sub directory do you want to create the MCP server in? (By default this is the MCP server project name)"
+    }
+  },
+  "required": ["name"]
+}