Lambda-MCP-Server

Overview

The Lambda-MCP-Server is a production-ready Python implementation that enables developers to deploy MCP servers on AWS Lambda with minimal boilerplate code. It provides a simple decorator-based approach for creating tools, built-in session state management using DynamoDB, and supports streamable HTTP for efficient communication. The server is actively maintained and provides example implementations for weather queries, S3 bucket counting, and time retrieval functions.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_weatherget_weather(city: str)

  Get the current weather for a city.

  Try:What's the weather like in New York?Try:Check the temperature in LondonTry:Get weather forecast for Tokyo
• count_s3_bucketscount_s3_buckets()

  Count the number of S3 buckets in your AWS account.

  Try:How many S3 buckets do I have?Try:List my AWS S3 buckets countTry:Show total number of S3 buckets
• get_timeget_time()

  Get the current UTC date and time.

  Try:What's the current time?Try:Show me UTC timeTry:Get current date and time
• increment_counterincrement_counter()

  Increment a session-based counter.

  Try:Increment the counterTry:Add one to the session counterTry:Increase the counter value
• get_counterget_counter()

  Get the current counter value.

  Try:What's the current counter value?Try:Show me the counterTry:Get current counter number

Comparable tools

Installation

pip install awslabs.mcp_lambda_handler

{
  "mcpServers": {
    "lambda-mcp": {
      "command": "python",
      "args": ["-m", "awslabs.mcp_lambda_handler"],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_AWS_KEY",
        "AWS_SECRET_ACCESS_KEY": "YOUR_AWS_SECRET"
      }
    }
  }
}

FAQ

What authentication methods are supported?

The server supports Bearer token authentication via API Gateway authorizers. It can be extended to support AWS IAM, OAuth 2.0, or Amazon Cognito for production use.

How is session state managed?

Session state is automatically managed using a DynamoDB table with the session ID as the key. Session data persists across tool invocations within the same conversation.

Compare Lambda-MCP-Server with