Run Model Context Protocol Servers With Aws Lambda

🚀 Run MCP Server Model with AWS Lambda

This project enables running the MCP server model using AWS Lambda, providing code examples in multiple languages.

🚀 Quick Start

💻 Usage Examples

Basic Usage

This project includes code examples in different programming languages to call the "time" MCP server function.

Python Server Example

This project contains a Python MCP client that calls the "time" MCP server function mentioned above. This client calls the Lambda function named "mcp-server-time" and returns a payload that conforms to the MCP protocol to the caller.

from mcp import ClientSession
from mcp_lambda import LambdaFunctionParameters, lambda_function_client

server_params = LambdaFunctionParameters(
    function_name="mcp-server-time",
    region_name="us-east-2",
)

read, write = await lambda_function_client(server_params)
session = ClientSession(read, write)
await session.initialize()

TypeScript Server Example

This project contains a TypeScript MCP client that calls the "time" MCP server function mentioned above. This client calls the Lambda function named "mcp-server-time" and returns a payload that conforms to the MCP protocol to the caller.

import {
  LambdaFunctionParameters,
  LambdaFunctionClientTransport,
} from "@aws/run-mcp-servers-with-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 client.connect(transport);

Deployment and Running Examples

Refer to the Development Guide for instructions on deploying and running the examples in this repository.

🔒 Security

For more information, please refer to CONTRIBUTING.

📄 License

This project is licensed under the Apache-2.0 license.