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

DEVELOP.md

@@ -39,7 +39,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 +57,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 +90,7 @@ cd examples/servers/weather-alerts/
 
 npm install
 
-npm link mcp-lambda
+npm link mcp-server-in-aws-lambda
 
 npm run build
 
@@ -118,7 +118,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/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";
 

examples/chatbots/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

examples/chatbots/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";
 

examples/servers/time/function/requirements.txt

@@ -1,4 +1,5 @@
 mcp-server-time
 
-# 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