用途:在 Cloudflare Workers 上用 TypeScript 与 @modelcontextprotocol/sdk 构建并部署远程 Model Context Protocol(MCP)服务器,资料称 Cloudflare 是 2025 年唯一官方支持远程 MCP 的平台。
主要能力:使用 McpAgent 基类注册工具、资源与提示,工具参数用 Zod 校验;支持 SSE 与 Streamable HTTP 双传输;提供四种认证模式(无认证、JWTVerifier 令牌校验、workers-oauth-provider 的 OAuth 代理、带 DCR 的远程 OAuth);用 Durable Objects 保存会话状态、缓存与限流;用 WebSocket 休眠 API 降低空闲连接成本。资料还列出 15 个常见错误及解决思路。
使用方式:可从模板创建,如 npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless,再 npm install、npm run dev,本地地址为 http://localhost:8788/sse;也可复制技能内模板。用 npx @modelcontextprotocol/inspector@latest 测试,npx wrangler deploy 部署,npx wrangler tail 查看日志。首次部署 Durable Objects 需在 wrangler.jsonc 配置 migrations。
适用场景:为 MCP 客户端(如 Claude Desktop)提供远程工具服务,封装外部 API、查询 D1/KV、实现多工具协作、缓存与限流。
限制:资料未提供具体收费与价格细节;OAuth 与 Durable Objects 配置较复杂,需正确设置绑定、迁移与环境变量,否则易出现连接、状态丢失或 CORS 等错误。