MCP Lambda Sam

🚀 MCP Lambda Project Documentation

MCP Lambda is a distributed computing platform built on the AWS serverless architecture. It offers a comprehensive solution for running and managing task workflows in the AWS Lambda environment. The platform is designed to be highly scalable, fault-tolerant, and capable of handling workloads of various sizes.

🚀 Quick Start

Install AWS SAM CLI

Install the AWS SAM CLI according to the official documentation and ensure it's in your system's PATH:

sam --version

Build and Deploy

Execute the following commands for building and deployment:

sam build
sam deploy --guided

Configure the stack name, region, and required features as prompted.

✨ Features

MCP Lambda Core Components

• Lambda Functions: Handle core business logic.
• DynamoDB Tables: Store task and status data.
• IAM Roles: Provide necessary permissions.
• SQS Queues: Facilitate asynchronous task communication.

Project Structure

mcp-lambda-sam/
├── template.yaml          # SAM template file
├── functions/            # Lambda function code
│   └── mcp-function/     # MCP core functionality
│       ├── src/           # Business logic code
│       └── package.json    # Dependency management
├── config/               # Configuration folder
│   └── parameters.json   # Parameter configuration
└── scripts/              # Script folder
    └── deploy.sh         # Deployment script

📦 Installation

Prerequisites

• AWS CLI installed and configured.
• AWS SAM CLI installed and available.
• Node.js version 20.x or higher.
• An AWS account with the following permissions:
  • Create Lambda functions.
  • Create DynamoDB tables.
  • Manage IAM roles.
  • Configure SQS queues.

Deployment Methods

Method 1: Use AWS Serverless Application Repository (SAR)

1. Visit the AWS Serverless Application Repository.
2. Search for "mcp-lambda-sam" and select the correct version for deployment.
3. Configure parameters:
   • StackIdentifier: A unique identifier (e.g., project name).
   • VpcEnabled: Whether to enable VPC support.
   • VpcId and SubnetIds: If VPC is enabled, fill in the relevant IDs.

Method 2: Use npx CLI

Installation command:

npx @markvp/mcp-lambda-sam deploy

This command will interactively prompt you to configure parameters, including stack name, region, and VPC settings.

Method 3: Programmatic Deployment

1. Install the package:

   npm install @markvp/mcp-lambda-sam
   

2. Use JavaScript for programmatic deployment:

   import { deploy } from '@markvp/mcp-lambda-sam';
   
   deploy();
   

Method 4: Local Development and Deployment

1. Install dependencies:

   npm install
   

2. Execute build and deployment commands:

   sam build && sam deploy --guided
   

📚 Documentation

Project Configuration

Parameter File (parameters.json)

{
  "StackName": "mcp-lambda-stack",
  "LambdaFunctionName": "mcp-function",
  "DynamoDBTableName": "mcp-dynamodb-table",
  "LogLevel": "INFO"
}

SAM Template (template.yaml)

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Resources:
  MCPFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: index.handler
      Runtime: nodejs18.x
      MemorySize: 128
      Timeout: 30

Project Execution Flow

Lambda Function Execution Steps

1. Initialize the function environment.
2. Load the configuration file.
3. Connect to the DynamoDB table.
4. Process specific business logic.
5. Record logs and update the status.

Exception Handling

• Timeout Handling: Set appropriate timeout policies to avoid long unresponsive periods.
• Error Retry: Configure the retry count and interval for Lambda functions.
• Failure Recovery: Implement a task retry mechanism using SQS and DynamoDB.

Logging and Monitoring

CloudWatch Monitoring

• Use CloudWatch to monitor the execution of Lambda functions.
• Set up alarm rules to detect and handle exceptions promptly.

Operational Logs

Lambda functions automatically output logs to CloudWatch Logs. The content includes:

• Request ID
• Execution time
• Error information

Project Expansion

High Availability Design

Achieve load balancing by configuring multiple AWS regions to improve system availability and reliability.

Auto Scaling

Leverage AWS's auto-scaling feature to dynamically adjust resource allocation based on actual load.

Security Measures

• Permission Management: Use IAM policies to restrict the permissions of Lambda functions.
• Network Isolation: Use VPC to isolate sensitive services.
• Encrypted Communication: Implement data transmission encryption via SSL/TLS.

Frequently Asked Questions

Q: How can I view the logs of a Lambda function?

A: Log in to the AWS Management Console, go to CloudWatch → Logs → Find the corresponding log group and log stream.

Q: What should I do if the deployment fails?

A: Check the stack status, view the error information, and resolve the issues according to the prompts. You can refer to the official documentation to solve common problems.

Appendix

Dependency Management

The project uses npm for dependency management:

npm install express aws-sdk --save

Script Example

Deployment script (deploy.sh):

#!/bin/bash
sam build && sam deploy --stack-name mcp-lambda-stack --region us-east-2

Project Maintenance

Update Dependencies

Regularly check and update the project's dependency packages to maintain security:

npm update express aws-sdk

Version Control

Use Git for version management. It is recommended to host the project on GitHub or other code repositories.

With the above documentation, you can successfully complete the deployment, configuration, and maintenance of the MCP Lambda project. For further information, please refer to the official documentation.