JinDaGe - mcp-server-http-wrapper MCP Details

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

这将：

清理 dist 目录
编译 TypeScript 代码
打包必要的文件，包括 MCP 服务器
使用 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 - 部署到生产环境

mcp-server-http-wrapper