← 返回目录
C

Cloudflare Workers Next.js SaaS Template

社区
为 Cloudflare Workers 打造的完整 Next.js SaaS 模板,内置用户认证、订阅计费和 AI 代理平台(含 MCP)
GitHub 源仓库 ↗
★ 782 Stars 分类 · 开发工具 非常热门 源版本 a7c106a3e01d
43FMRS · D
可靠性
5/20
安全与权限
8/20
维护活跃度
10/20
文档质量
12/20
安装易用性
8/20

该模板功能全面,但复杂度较高,适合经验丰富的开发者。其 MCP 服务器集成设计良好,工具从 OpenAPI 自动派生,并支持多种客户端连接方式。

查看 FMRS 评分方法 →

这是一个开源的 SaaS 模板,用于在 Cloudflare Workers 上运行 Next.js 应用。它使用 Vinext(Cloudflare 基于 Vite 的实验性 Next.js 实现)作为构建和部署工具链,支持 App Router、React Server Components 等。模板集成了用户认证(Lucia Auth)、数据库(Drizzle + D1)、邮件服务、团队订阅计费(Stripe)、内容管理系统、管理员面板以及一个 AI 代理平台,包括公共 REST API、OAuth 2.1 和远程 MCP 服务器。该 MCP 服务器由 OpenAPI 文档自动派生出工具,并支持通过 OAuth 或 API 密钥进行认证。

工具能力

mcp_server
导出由 OpenAPI 文档派生的各种工具,允许 AI 代理与该 SaaS 平台的公共 API 交互。

安装接入

该模板需要自行部署。部署后,MCP 服务器端点位于 /mcp。要连接,请使用 MCP 客户端向该 URL 发起连接。对于 CLI 和编辑器客户端,可以设置 Authorization: Bearer 头(使用 API 密钥)或使用 OAuth 授权流程。

选型与风险

适合谁

  • 开发者希望快速搭建一个具有内置 AI 平台和 MCP 功能的 SaaS 产品
  • 需要为 AI 代理提供全面的认证和授权机制(OAuth、API 密钥)的团队

不适合谁

  • 不需要 AI 代理功能或 MCP 服务器的简单项目
  • 希望使用 Node.js 服务器而非 Cloudflare Workers 的部署场景

所需权限

  • 需要 Cloudflare 账户和相关的 Worker 绑定(D1、KV、R2、AI 等)
  • 需要 Stripe 账户和 API 密钥以启用计费功能
  • 需要配置 Turnstile 密钥用于验证码

风险与副作用

  • 该模板是实验性的,Vinext 和 Cloudflare 的 MCP 组件可能会发生变化
  • MCP 服务器允许 AI 代理访问你的公共 API 的功率;若 API 密钥或 OAuth 凭据泄露,可能导致未授权访问
  • 部署配置复杂,需要仔细设置环境变量和绑定

常见排障

  1. 确保 `wrangler.jsonc` 中的 Cloudflare 绑定(如 `OAUTH_KV`)配置正确
  2. 运行 `pnpm run typecheck` 和 `pnpm run lint` 检查代码错误
  3. 使用 `pnpm run test:e2e` 测试端到端流程
  4. 检查 `src/constants.ts` 中的 API 密钥前缀,确保它们已品牌化

使用场景

为你的 SaaS 应用提供 AI 代理集成,允许它们执行 API 操作(如管理资源)
将 MCP 服务器作为模板的远程 MCP 端点,供 Claude Code、ChatGPT、Cursor 等客户端使用

支持客户端

Claude Code完整支持
claude.ai完整支持
ChatGPT完整支持
Cursor完整支持
VS Code完整支持
Codex完整支持
Antigravity完整支持
Grok CLI完整支持