feat!: namespace the Typescript module

Author: clareliguori

.github/workflows/cdk-checks.yml

@@ -47,12 +47,12 @@ jobs:
       - name: Install CDK CLI
         run: npm install -g aws-cdk
 
-      - name: Build and link run-mcp-servers-with-aws-lambda package
+      - name: Build and link local package
         run: npm ci && npm run build && npm link
         working-directory: ./src/typescript
 
       - name: Install dependencies
-        run: npm ci && npm link run-mcp-servers-with-aws-lambda
+        run: npm ci && npm link @aws/run-mcp-servers-with-aws-lambda
         working-directory: ./examples/servers/weather-alerts
 
       - name: Build

.github/workflows/typescript-checks.yml

@@ -42,12 +42,12 @@ jobs:
         with:
           node-version: 20
 
-      - name: Build and link run-mcp-servers-with-aws-lambda package
+      - name: Build and link local package
         run: npm ci && npm run build && npm link
         working-directory: ./src/typescript
 
       - name: Install dependencies
-        run: npm ci && npm link run-mcp-servers-with-aws-lambda
+        run: npm ci && npm link @aws/run-mcp-servers-with-aws-lambda
         working-directory: ./examples/chatbots/typescript
 
       - name: Build

DEVELOP.md

@@ -1,14 +1,5 @@
 # Development guide
 
-## Local tools
-
-Install pre-commit hooks to ensure that your commits follow conventional commit guidelines:
-
-```
-pip install pre-commit
-pre-commit install
-```
-
 ## Deploy and run the examples
 
 This guide will walk you through building the source code in this repository,
@@ -68,7 +59,7 @@ uv run pytest
 
 ### Build the Typescript package
 
-Build the run-mcp-servers-with-aws-lambda Typescript module:
+Build the @aws/run-mcp-servers-with-aws-lambda Typescript module:
 
 ```bash
 cd src/typescript/
@@ -101,7 +92,7 @@ cd examples/servers/weather-alerts/
 
 npm install
 
-npm link run-mcp-servers-with-aws-lambda
+npm link @aws/run-mcp-servers-with-aws-lambda
 
 npm run build
 
@@ -129,9 +120,18 @@ cd examples/chatbots/typescript/
 
 npm install
 
-npm link run-mcp-servers-with-aws-lambda
+npm link @aws/run-mcp-servers-with-aws-lambda
 
 npm run build
 
 npm run start
 ```
+
+## Development tools
+
+Install pre-commit hooks to ensure that your commits follow conventional commit guidelines:
+
+```
+cd src/python
+uv run pre-commit install
+```

README.md

@@ -133,7 +133,7 @@ const serverParams = {
 export const handler: Handler = async (event, context: Context) => {
   // Dynamically import ES module into CommonJS Lambda function
   const { stdioServerAdapter } = await import(
-    "run-mcp-servers-with-aws-lambda"
+    "@aws/run-mcp-servers-with-aws-lambda"
   );
 
   return await stdioServerAdapter(serverParams, event, context);
@@ -174,7 +174,7 @@ with the MCP protocol and returns the function's response to the caller.
 import {
   LambdaFunctionParameters,
   LambdaFunctionClientTransport,
-} from "run-mcp-servers-with-aws-lambda";
+} from "@aws/run-mcp-servers-with-aws-lambda";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 
 const serverParams: LambdaFunctionParameters = {

e2e_tests/run_integ_test.sh

@@ -25,7 +25,7 @@ npm link
 
 cd ../../examples/servers/weather-alerts/
 npm ci
-npm link run-mcp-servers-with-aws-lambda
+npm link @aws/run-mcp-servers-with-aws-lambda
 npm run build
 cdk deploy --app 'node lib/weather-alerts-mcp-server.js'
 
@@ -42,6 +42,6 @@ python main.py
 # Run the Typescript integ test
 cd ../typescript/
 npm ci
-npm link run-mcp-servers-with-aws-lambda
+npm link @aws/run-mcp-servers-with-aws-lambda
 npm run build
 npm test

e2e_tests/typescript/src/server_clients/lambda_function.ts

@@ -1,7 +1,7 @@
 import {
   LambdaFunctionParameters,
   LambdaFunctionClientTransport,
-} from "run-mcp-servers-with-aws-lambda";
+} from "@aws/run-mcp-servers-with-aws-lambda";
 import { Server } from "./server.js";
 import logger from "../logger.js";
 

examples/chatbots/typescript/src/server_clients/lambda_function.ts

@@ -1,7 +1,7 @@
 import {
   LambdaFunctionParameters,
   LambdaFunctionClientTransport,
-} from "run-mcp-servers-with-aws-lambda";
+} from "@aws/run-mcp-servers-with-aws-lambda";
 import { Server } from "./server.js";
 import logger from "../logger.js";
 

examples/servers/weather-alerts/lib/weather-alerts-mcp-server.function.ts

@@ -8,7 +8,7 @@ const serverParams = {
 export const handler: Handler = async (event, context: Context) => {
   // Dynamically import ES module into CommonJS Lambda function
   const { stdioServerAdapter } = await import(
-    "run-mcp-servers-with-aws-lambda"
+    "@aws/run-mcp-servers-with-aws-lambda"
   );
 
   return await stdioServerAdapter(serverParams, event, context);

examples/servers/weather-alerts/lib/weather-alerts-mcp-server.ts

@@ -15,8 +15,8 @@ export class WeatherAlertsMcpServer extends cdk.Stack {
   ) {
     super(scope, id, props);
 
-    // For testing, the run-mcp-servers-with-aws-lambda package is bundled from local files.
-    // Remove this layer if using the run-mcp-servers-with-aws-lambda package from npm.
+    // For testing, the @aws/run-mcp-servers-with-aws-lambda package is bundled from local files.
+    // Remove this layer if using the @aws/run-mcp-servers-with-aws-lambda package from npm.
     const mcpLambdaLayer = new LayerVersion(this, "McpLambdaLayer", {
       code: Code.fromAsset(path.join(__dirname, "../../../../src/typescript"), {
         bundling: {
@@ -25,8 +25,8 @@ export class WeatherAlertsMcpServer extends cdk.Stack {
             "bash",
             "-c",
             [
-              "mkdir -p /asset-output/nodejs/node_modules/run-mcp-servers-with-aws-lambda",
-              `cp -r /asset-input/* /asset-output/nodejs/node_modules/run-mcp-servers-with-aws-lambda/`,
+              "mkdir -p /asset-output/nodejs/node_modules/@aws/run-mcp-servers-with-aws-lambda",
+              `cp -r /asset-input/* /asset-output/nodejs/node_modules/@aws/run-mcp-servers-with-aws-lambda/`,
             ].join(" && "),
           ],
         },
@@ -53,9 +53,9 @@ export class WeatherAlertsMcpServer extends cdk.Stack {
       layers: [mcpLambdaLayer],
       bundling: {
         nodeModules: ["openapi-mcp-server"],
-        // For testing, the run-mcp-servers-with-aws-lambda package is bundled from local files using the Lambda layer above.
-        // Remove the layer and this externalModules configuration if using the run-mcp-servers-with-aws-lambda package from npm.
-        externalModules: ["run-mcp-servers-with-aws-lambda"],
+        // For testing, the @aws/run-mcp-servers-with-aws-lambda package is bundled from local files using the Lambda layer above.
+        // Remove the layer and this externalModules configuration if using the @aws/run-mcp-servers-with-aws-lambda package from npm.
+        externalModules: ["@aws/run-mcp-servers-with-aws-lambda"],
         commandHooks: {
           beforeBundling(inputDir: string, outputDir: string): string[] {
             return [];

src/typescript/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "run-mcp-servers-with-aws-lambda",
+  "name": "@aws/run-mcp-servers-with-aws-lambda",
   "description": "Run Model Context Protocol (MCP) servers with AWS Lambda",
   "version": "0.0.2",
   "type": "module",