mcp-proxy Skill 技能

mcp-proxy 是 Model Context Protocol 的 TypeScript 流式 HTTP 和 SSE 代理，专为将基于 stdio 传输的 MCP 服务器转换为可通过 HTTP 访问的服务而设计。这是 FastMCP 用来启用流式 HTTP 和 SSE 传输的核心依赖。核心能力：1) 协议兼容性：同时服务 2025-era 和 2026-07-28 两种协议修订版，客户端无需知道另一版本的存在；2) 传输转换：将 stdio 协议的 MCP 服务器转换为 streamable HTTP（/mcp）和 SSE（/sse）两种下游接口；3) 无状态模式：支持每个请求创建新服务器实例，适合无服务器环境或需要请求隔离的场景；4) API Key 认证：可选 X-API-Key 认证，保护 MCP 服务不被未授权访问；5) CORS 配置：默认启用且宽松，支持精细化配置来源白名单、自定义请求头、凭证等；6) 公共隧道：内置 pipenet 隧道支持，可将本地服务暴露到公网用于 Webhook 测试或远程访问；7) 事件存储：streamable HTTP 传输的可达性事件存储默认开启，支持客户端断线重连后从断点恢复（可配置上限防止内存膨胀）；8) TLS/SSL 支持：支持自定义 CA 证书、服务端证书和私钥。技术亮点：单一上游连接多路复用到所有下游连接（设计决策，限制了某些能力如客户端身份溯源和 2026-07-28 的输入请求）；支持 2025-era 和 2026-07-28 双协议族的下游服务；内置日志级别、请求体大小限制（默认 10MiB）、连接超时等生产级配置。适用场景：把只能通过 stdio 工作的 MCP 服务器（如很多 Python MCP 服务）暴露为 HTTP API 供浏览器端或跨网络调用；在无服务器环境（AWS Lambda、Vercel）部署 MCP 服务；需要负载均衡多个 MCP 客户端请求到同一个后端服务；为 MCP 服务增加认证和 TLS 安全层；测试 Webhook 回调场景需要公网可达的本地服务。安装：npm install mcp-proxy，使用 CLI（npx mcp-proxy）或 Node.js SDK（startHTTPServer）两种方式调用。