返回 MCP 目录
public公开dns本地运行

simple-mcp-server-on-lambda

一个简单的MCP服务器原型,直接在AWS Lambda和API Gateway上原生运行,无需额外桥接组件或自定义传输。

article

README

🚀 简单的Lambda上的MCP服务器

本项目是一个可在AWS Lambda和Amazon API Gateway上原生运行的简单MCP服务器,无需额外的桥接组件或自定义传输。这得益于v2025 - 03 - 26引入的可流式HTTP传输。不过要注意,这目前只是个原型。

架构图

架构尽可能简单,如下所示:

🚀 快速开始

✨ 主要特性

  • 可在AWS Lambda和Amazon API Gateway上原生运行。
  • 无需额外的桥接组件或自定义传输。

📦 安装指南

先决条件

  • AWS CLI
  • Terraform

安装步骤

  1. 安装依赖项
cd src
npm install
cd ..
  1. 引导服务器并设置带有MCP服务器端点的环境变量
cd terraform
terraform init
terraform plan
terraform apply
export SIMPLE_MCP_SERVER_ENDPOINT=$(terraform output --raw endpoint_url) 
cd ..

⚠️ 重要提示

API Gateway端点可能需要几秒钟才能运行。

💻 使用示例

基础用法

  1. 运行客户端
node src/client.js
  1. 查看响应
> node client.js
> listTools response:  { tools: [ { name: 'ping', inputSchema: [Object] } ] }
> callTool:ping response:  { content: [ { type: 'text', text: 'pong' } ] }

📚 详细文档

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端