SuperAPI AI 工具集

building-mcp-server-on-cloudflare

智能体与模型

查看项目

更新于 10-16 03:05

技能介绍

用途:在 Cloudflare Workers 上构建远程 MCP 服务器,向 MCP 客户端暴露工具,并支持部署到生产环境。涉及 MCP SDK 与 Workers 集成时建议优先检索官方文档而非依赖预训练知识。

主要能力:定义 MCP 工具(server.tool())、用 Zod 做输入校验、返回文本内容、访问 Workers 环境绑定(如 D1、KV);提供无认证与 OAuth 认证两种服务端模板;支持 GitHub、Google、Auth0、Stytch、WorkOS 及任意 OAuth 2.0 提供方;通过 Wrangler 部署,并用 MCP Inspector 本地测试。

使用方式: 无认证服务器: npm create cloudflare@latest -- my-mcp-server
--template=cloudflare/ai/demos/remote-mcp-authless 带认证服务器: npm create cloudflare@latest -- my-mcp-server
--template=cloudflare/ai/demos/remote-mcp-github-oauth 本地运行 npm start,服务位于 http://localhost:8788/mcp;用 npx @modelcontextprotocol/inspector@latest 测试;部署执行 npx wrangler deploy,服务位于 https://[worker-name].[account].workers.dev/mcp;客户端连接示例:codex mcp add my-server -- npx mcp-remote https://my-mcp.workers.dev/mcp,修改配置后需重启 Codex。

适用场景:需要构建远程 MCP 服务器、通过 MCP 暴露工具、处理 MCP 认证或 OAuth、将 MCP 部署到 Cloudflare Workers。

前提与限制:需要启用 Workers 的 Cloudflare 账户、Node.js 18+ 与 npm/pnpm/yarn、Wrangler CLI(npm install -g wrangler)。OAuth 认证需另行配置 OAuth 应用,回调 URL 必须与配置完全一致,本地开发使用 http://localhost:8788/callback。常见问题包括工具名称大小写不匹配、端点路径须为 /mcp、浏览器客户端需检查 CORS。具体定价、配额及更多细节资料未提供。