MCP Middleware Adapter for Express Servers

基本能力

产品定位

mcp-express-adapter 是一个轻量级的适配器，用于在 Express.js 服务器上创建 MCP (Model Context Protocol) 服务。它旨在简化 MCP 实例的部署、更新和维护。

核心功能

• Express 中间件集成，支持 SSE (Server-Sent Events)
• 工具实现，支持 TypeScript
• 基于头的授权支持
• 在同一 Express 服务器上托管多个 MCP 客户端
• 调试模式支持

适用场景

• 需要扩展和管理多个 MCP 客户端的场景
• 需要将 MCP 客户端与主 LLM 服务分离的场景
• 需要简化 MCP 实例部署和维护的场景

工具列表

• get_weather: 获取指定位置的天气信息
• calculate: 计算两个数字的和
• generate_list: 根据类别生成项目列表
• greeting: 生成个性化的问候语
• get_passcode: 获取用户的密码（需要授权）

常见问题解答

• 确保在应用 express.json() 中间件之前应用 MCP 中间件
• WebSocket 集成尚未经过充分测试

使用教程

使用依赖

安装 Node.js 和 npm/yarn/pnpm。

安装教程

npm install mcp-express-adapter@latest
# 或
yarn add mcp-express-adapter@latest
# 或
pnpm add mcp-express-adapter@latest

调试方式

启动服务器后，可以通过以下命令测试 SSE 端点：

curl -N http://localhost:3000/mcp/sse

或使用 MCP 命令行客户端：

npx mcp-express-adapter --host http://localhost:3000/mcp/sse

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。