このプロジェクトにより、AWS Lambda関数内でモデルコンテキストプロトコルのスタンディオベースのサーバーを運用できるようになります。

現在、MCPサーバーとクライアントのほとんどの実装は、単一のマシン上で完全にローカル化されています。 IDEやClaude Desktopのようなデスクトップアプリケーションは、MCPサーバーを子プロセスとしてローカルで起動します そして、それらのサーバーと長期運行のStDiOストリームを通じて通信します。

このライブラリは、既存のstdio MCPサーバーをLambda関数にラップするのに役立ちます。 これらの関数ベースのMCPサーバーは、MCPプロトコルを使ってアプリケーションから呼び出すことができます 短命なHTTPS接続を介して。 あなたのアプリケーションはデスクトップベースのアプリ、クラウド上で動作する分散システムにもなり得ます。 または他の建築のことです。

このライブラリを使えば、Lambda関数がStdio MCPサーバーのライフサイクルを管理します。 各ラムダ関数呼び出しは以下の通りになります:

1. stdio MCPサーバーを子プロセスとして起動
2. MCPサーバーの初期化
3. 受信リクエストをローカルサーバーに転送する
4. サーバの応答を関数呼び出し者に返す
5. MCPサーバーの子プロセスをシャットダウンする

このライブラリは、4つの方法でラムダベースのMCPサーバーへの接続をサポートしています。

Run Model Context Protocol (MCP) servers with AWS Lambda

This project enables you to run Model Context Protocol stdio-based servers in AWS Lambda functions.

Currently, most implementations of MCP servers and clients are entirely local on a single machine. A desktop application such as an IDE or Claude Desktop initiates MCP servers locally as child processes and communicates with each of those servers over a long-running stdio stream.

flowchart LR
    subgraph "Your Laptop"
        Host["Desktop Applicationwith MCP Clients"]
        S1["MCP Server A(child process)"]
        S2["MCP Server B(child process)"]
        Host |"MCP Protocol(over stdio stream)"| S1
        Host |"MCP Protocol(over stdio stream)"| S2
    end

This library helps you to wrap existing stdio MCP servers into Lambda functions. You can invoke these function-based MCP servers from your application using the MCP protocol over short-lived HTTPS connections. Your application can then be a desktop-based app, a distributed system running in the cloud, or any other architecture.

flowchart LR
    subgraph "Distributed System"
        App["Your Applicationwith MCP Clients"]
        S3["MCP Server A(Lambda function)"]
        S4["MCP Server B(Lambda function)"]
        App |"MCP Protocol(over HTTPS connection)"| S3
        App |"MCP Protocol(over HTTPS connection)"| S4
    end

Using this library, the Lambda function will manage the lifecycle of your stdio MCP server. Each Lambda function invocation will:

1. Start the stdio MCP server as a child process
2. Initialize the MCP server
3. Forward the incoming request to the local server
4. Return the server’s response to the function caller
5. Shut down the MCP server child process

This library supports connecting to Lambda-based MCP servers in four ways:

1. The MCP Streamable HTTP transport, using Amazon API Gateway. Typically authenticated using OAuth.
2. The MCP Streamable HTTP transport, using Amazon Bedrock AgentCore Gateway. Authenticated using OAuth.
3. A custom Streamable HTTP transport with support for SigV4, using a Lambda function URL. Authenticated with AWS IAM.
4. A custom Lambda invocation transport, using the Lambda Invoke API directly. Authenticated with AWS IAM.

Determine your server parameters