用途:在 Cloudflare Workers 上创建生产可用的远程 MCP 服务器,向 MCP 客户端暴露工具,并支持认证与部署。适用于需要构建远程 MCP 服务器、通过 MCP 暴露工具、配置 MCP 认证或 OAuth、以及将 MCP 部署到 Cloudflare Workers 的场景。
前置条件:启用 Workers 的 Cloudflare 账户;Node.js 18+ 与 npm/pnpm/yarn;Wrangler CLI(npm install -g wrangler)。
快速开始:无认证公开服务器可用 npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless,随后 npm start,服务运行于 http://localhost:8788/mcp。带 OAuth 认证的服务器使用 --template=cloudflare/ai/demos/remote-mcp-github-oauth,需先配置 OAuth 应用。
核心流程:用 server.tool() 定义工具,参数可用 Zod 校验;在 src/index.ts 配置入口,通过 MyMCP.serveSSE("/mcp") 暴露;本地用 npx @modelcontextprotocol/inspector@latest 测试;用 npx wrangler deploy 部署,地址为 https://[worker-name].[account].workers.dev/mcp;客户端(如 Claude Desktop)通过 mcp-remote 连接。
认证支持 GitHub、Google、Auth0、Stytch、WorkOS 及任意 OAuth 2.0 兼容提供方。Wrangler 配置需声明 Durable Objects 绑定与迁移,并可添加 D1、KV 等绑定。
限制与排错:工具名区分大小写,需在 init() 中注册;连接失败时确认路径为 /mcp、检查 CORS 与部署状态;OAuth 回调地址须与配置完全一致。更多示例、OAuth 配置与排错见技能内 references 文档。