Simple MCP Server on Lambda

Simple MCP Server on Lambda

site icon
2025.04.18 4
JavaScriptMCP 协议实现无服务器架构其它
simple-mcp-server-on-lambda 是一个运行在 AWS Lambda 和 Amazon API Gateway 上的简单 MCP 服务器,无需额外的桥接组件或自定义传输。它利用了 MCP 协议中的 Streamable HTTP 传输功能,是一个原型实现。
View on GitHub

Overview

基本能力

产品定位

simple-mcp-server-on-lambda 是一个轻量级的 MCP 服务器,旨在展示如何在 AWS Lambda 和 API Gateway 上原生运行 MCP 服务。

核心功能

  • 原生运行在 AWS Lambda 和 API Gateway 上
  • 支持 MCP 协议的 Streamable HTTP 传输
  • 提供简单的工具调用功能(如 ping 工具)

适用场景

  • MCP 协议的原型验证
  • 在无服务器架构上部署 MCP 服务
  • 快速测试 MCP 工具调用

工具列表

  • ping:一个简单的测试工具,返回 "pong" 作为响应

常见问题解答

  • 部署后可能需要等待几秒钟 API Gateway 端点才能正常使用

使用教程

使用依赖

  • AWS CLI
  • Terraform

安装教程

  1. 安装依赖:
cd src
npm install
cd ..
  1. 启动服务器并设置环境变量:
cd terraform
terraform init
terraform plan
terraform apply
export SIMPLE_MCP_SERVER_ENDPOINT=$(terraform output --raw endpoint_url)
cd ..

调试方式

运行客户端测试:

node src/client.js

预期输出:

> node client.js
> listTools response:  { tools: [ { name: 'ping', inputSchema: [Object] } ] }
> callTool:ping response:  { content: [ { type: 'text', text: 'pong' } ] }

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。