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

mcp-server-http-wrapper

AWS Lambda的HTTP包装器,用于Model Context Protocol服务器,提供本地开发和云端部署功能。

article

README

🚀 MCP HTTP 包装器

MCP HTTP 包装器是运行在 AWS Lambda 上的 HTTP 包装器,专为 Model Context Protocol 服务器打造,能有效提升服务器的运行效率和灵活性。

🚀 快速开始

MCP HTTP 包装器是一个运行在 AWS Lambda 上的 HTTP 包装器,用于 Model Context Protocol 服务器。使用前,请确保满足以下先决条件,并按照安装步骤进行操作。

✨ 主要特性

  • 基于 AWS Lambda 运行,具备高扩展性和弹性。
  • 为 Model Context Protocol 服务器提供 HTTP 包装,方便与其他系统集成。

📦 安装指南

先决条件

  • Node.js (v18 或更高版本)
  • 配置了适当凭证的 AWS CLI
  • Serverless Framework

安装依赖

npm install

设置 MCP 服务器

在测试或部署之前,需要安装依赖项并构建每个 MCP 服务器:

# 进入每个 MCP 服务器目录并安装依赖项
cd mcp_servers/[server-name]
npm install
npm run build

# 对于 mcp_servers/ 目录下的每个服务器目录重复上述步骤

💻 使用示例

本地开发

使用 Serverless Offline 本地运行服务

npm run dev

使用 Express 更方便地调试

npm run dev:express

部署

配置 AWS 凭证

在部署之前,确保已配置 AWS 凭证:

aws configure

准备 MCP 服务器

确保在部署前构建了所有 MCP 服务器(参见设置 MCP 服务器部分)。

部署到开发环境

npm run deploy

这将:

  1. 清理 dist 目录
  2. 编译 TypeScript 代码
  3. 打包必要的文件,包括 MCP 服务器
  4. 使用 Serverless Framework 部署到 AWS

部署到生产环境

npm run deploy:prod

API 使用方法

列出可用工具

GET /{serverName}

调用工具

POST /{serverName}/{toolName}
{
  "param1": "value1",
  "param2": "value2"
}

根据特定的 MCP 服务器配置,必须包含所需的头信息。

📚 详细文档

项目结构

  • src/index.ts - 主 Lambda 处理函数
  • src/mcp/mcp-server-config.ts - 可用 MCP 服务器的配置
  • src/mcp/mcp-client-handler.ts - MCP 客户端通信处理程序
  • mcp_servers/ - 包含 MCP 服务器实现的目录
  • serverless.yml - Serverless Framework 配置

脚本

  • npm run build - 编译 TypeScript
  • npm run watch - 监视 TypeScript 变更
  • npm run clean - 删除 dist 目录
  • npm run dev - 本地运行服务
  • npm run deploy - 部署到开发环境
  • npm run deploy:prod - 部署到生产环境
help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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