feat!: Rename the module to mcp-server-in-aws-lambda

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 mcp-lambda package
+      - name: Build and link mcp-server-in-aws-lambda package
         run: npm ci && npm run build && npm link
         working-directory: ./src/typescript
 
       - name: Install dependencies
-        run: npm ci && npm link mcp-lambda
+        run: npm ci && npm link mcp-server-in-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 mcp-lambda package
+      - name: Build and link mcp-server-in-aws-lambda package
         run: npm ci && npm run build && npm link
         working-directory: ./src/typescript
 
       - name: Install dependencies
-        run: npm ci && npm link mcp-lambda
+        run: npm ci && npm link mcp-server-in-aws-lambda
         working-directory: ./examples/chatbots/typescript
 
       - name: Build

.pre-commit-config.yaml

@@ -0,0 +1,11 @@
+default_install_hook_types:
+  - pre-commit
+  - commit-msg
+
+repos:
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.0.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args: []

CHANGELOG.md

@@ -2,4 +2,4 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
-## [0.0.2](https://github.com/awslabs/utilities-for-model-context-protocol-with-aws-lambda/compare/v0.0.1...v0.0.2) (2025-04-01)
+## [0.0.2](https://github.com/awslabs/run-model-context-protocol-servers-in-aws-lambda/compare/v0.0.1...v0.0.2) (2025-04-01)

DEVELOP.md

@@ -1,3 +1,14 @@
+# 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,
@@ -39,7 +50,7 @@ cdk bootstrap aws://<aws account id>/us-east-2
 
 ### Build the Python module
 
-Install the mcp-lambda Python module from source:
+Install the mcp-server-in-aws-lambda Python module from source:
 
 ```bash
 cd src/python/
@@ -57,7 +68,7 @@ uv run pytest
 
 ### Build the Typescript package
 
-Build the mcp-lambda Typescript module:
+Build the mcp-server-in-aws-lambda Typescript module:
 
 ```bash
 cd src/typescript/
@@ -90,7 +101,7 @@ cd examples/servers/weather-alerts/
 
 npm install
 
-npm link mcp-lambda
+npm link mcp-server-in-aws-lambda
 
 npm run build
 
@@ -118,7 +129,7 @@ cd examples/chatbots/typescript/
 
 npm install
 
-npm link mcp-lambda
+npm link mcp-server-in-aws-lambda
 
 npm run build
 

README.md

@@ -47,7 +47,7 @@ flowchart LR
 - This package currently supports MCP servers and clients written in Python and Typescript.
   Other languages such as Kotlin are not supported.
 - The server adapters only adapt stdio MCP servers, not servers written for other protocols such as SSE.
-- The server adapters does not maintain any MCP server state across Lambda function invocations.
+- The server adapters do not maintain any MCP server state across Lambda function invocations.
   Only stateless MCP servers are a good fit for using this adapter. For example, MCP servers
   that invoke stateless tools like the [time MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/time)
   or make stateless web requests like the [fetch MCP server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch).
@@ -124,14 +124,16 @@ It will:
 
 ```typescript
 import { Handler, Context } from "aws-lambda";
-import { stdioServerAdapter } from "mcp-lambda";
 
 const serverParams = {
   command: "npx",
   args: ["--offline", "openapi-mcp-server", "./weather-alerts-openapi.json"],
 };
 
 export const handler: Handler = async (event, context: Context) => {
+  // Dynamically import ES module into CommonJS Lambda function
+  const { stdioServerAdapter } = await import("mcp-server-in-aws-lambda");
+
   return await stdioServerAdapter(serverParams, event, context);
 };
 ```
@@ -170,15 +172,28 @@ with the MCP protocol and returns the function's response to the caller.
 import {
   LambdaFunctionParameters,
   LambdaFunctionClientTransport,
-} from "mcp-lambda";
+} from "mcp-server-in-aws-lambda";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 
 const serverParams: LambdaFunctionParameters = {
   functionName: "mcp-server-time",
   regionName: "us-east-2",
 };
 
+const client = new Client(
+  {
+    name: "my-client",
+    version: "0.0.1",
+  },
+  {
+    capabilities: {
+      sampling: {},
+    },
+  }
+);
+
 const transport = new LambdaFunctionClientTransport(serverParams);
-await this.client.connect(transport);
+await client.connect(transport);
 ```
 
 ### Deploy and run the examples

e2e_tests/python/requirements.txt

@@ -2,5 +2,6 @@ boto3>=1.36.20,<1.37.24
 mcp>=1.6.0
 uvicorn>=0.32.1
 
-# For testing, this module is installed from local files
-# mcp-lambda
+# For testing, this module is installed from local files.
+# Uncomment this line to build using the module from PyPi
+# mcp-server-in-aws-lambda >= 0.0.1

e2e_tests/run_integ_test.sh

@@ -25,7 +25,7 @@ npm link
 
 cd ../../examples/servers/weather-alerts/
 npm ci
-npm link mcp-lambda
+npm link mcp-server-in-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 mcp-lambda
+npm link mcp-server-in-aws-lambda
 npm run build
 npm test

e2e_tests/setup/setup.md

@@ -4,7 +4,7 @@ To set up an AWS account for running integration tests on GitHub:
 aws cloudformation deploy \
     --template-file integ-test-authentication.yaml \
     --stack-name github-integ-test-identity-provider \
-    --parameter-overrides GitHubOrg=awslabs RepositoryName=utilities-for-model-context-protocol-with-aws-lambda \
+    --parameter-overrides GitHubOrg=awslabs RepositoryName=run-model-context-protocol-servers-in-aws-lambda \
     --capabilities CAPABILITY_NAMED_IAM \
     --region us-east-2
 

e2e_tests/typescript/src/server_clients/lambda_function.ts

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