← 返回目录

Cloudflare Workers Next.js SaaS Template

社区

为 Cloudflare Workers 打造的完整 Next.js SaaS 模板，内置用户认证、订阅计费和 AI 代理平台（含 MCP）

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 327 / 438
Stars: ★ 787 非常热门
传输方式: Streamable HTTP
运行环境: Node.js · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 3 天前
工具数: 1

43FMRS · D

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

最强项 · 文档质量 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

10/20

文档质量

12/20

安装易用性

8/20

查看各项评分依据

可靠性 5/20: 仅提供了 README 与仓库元数据，未提供任何可执行的源码、CI 配置或测试文件。README 声称存在 /mcp Streamable HTTP 端点、由 OpenAPI 文档派生的工具列表以及单元/集成/端到端测试，但由于缺少源文件，MCP 初始化握手和工具行为完全无法验证。未发现自相矛盾的描述，快乐路径看似合理；按静态校准规则，没有可验证的执行证据，可靠性不能高于 12。扣分原因：无源码级验证、无已提交测试佐证、MCP 服务器只是基于实验性 Vinext 的大型模板中的一小部分。
安全与权限 8/20: 在提供的材料中未发现红线问题：无真实令牌/密钥示例、无隐蔽外传或恶意行为描述。README 描述了相对克制且按最小权限设计的安全方案：API 密钥仅存哈希并一次性显示、按作用域过滤工具、按凭据限流、OAuth 同意页、用户自助撤销、管理员复核动态注册的 OAuth 应用。但该模板暴露面较大（公开 API、OAuth 2.1 授权服务器、动态客户端注册、Stripe 订阅 webhook、管理后台），且实现无法从源文件中审计；部署和支付等有副作用操作的确认机制也未在提供材料中体现。扣分原因：无可审计源码、攻击面大、最小权限实践无法核实。
维护活跃度 10/20: 元数据显示仓库未归档、MIT 许可、仅 1 个未关闭 issue；README 内容详尽并带有 CI 徽标，且包含近期新增功能（i18n、AI 代理平台、年度计费等），说明项目活跃并有持续演进。但提供的材料中没有提交历史、发布记录或依赖更新证据；star 数仅作为发现信号，不计分。扣分原因：发布节奏、issue 响应时效和安全通告渠道均无法验证。
文档质量 12/20: README 是分层文档，覆盖本地安装、Stripe 计费、公开 API/OAuth/MCP、命令速查、生产部署技能、扩展指引，以及 Claude Code、claude.ai、ChatGPT、Cursor、VS Code、Codex、Antigravity、Grok CLI 的接入示例，并披露了 Vinext 的实验性状态和数据库迁移预检。但 README 属于不可信证据，且没有源码内文档可供交叉核对；MCP 端点本身的排错信息较薄弱。扣分原因：文档与实现的一致性无法验证、缺少针对 MCP 的具体故障排查指引。
安装易用性 8/20: README 给出了从零开始的明确命令序列（pnpm install、wrangler login、复制 .env、数据库迁移、seed、dev），MCP 接入方式也清晰：粘贴远程 MCP URL 并完成 OAuth 授权，或使用 Bearer API 密钥，并附各主流客户端片段。但完整搭建依赖 Cloudflare 账号以及 D1/KV/R2、Turnstile、Email、Stripe 等多个外部服务，且运行在实验性的 Vinext/Vite 工具链上，属手动且脆弱；提供的文件中没有可验证的 CI/执行证据，按静态校准不应超过 15。扣分原因：步骤多、外部依赖重、运行时具有实验性质。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据连接数据库

适合谁

开发者希望快速搭建一个具有内置 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 凭据泄露，可能导致未授权访问
部署配置复杂，需要仔细设置环境变量和绑定

安装接入

准备工作

运行环境：Node.js · 远程托管（无需本地环境）

STRIPE_SECRET_KEY 可选密钥 Stripe 密钥（sk_test_...），从 Stripe 控制台获取；启用计费功能所必需。

STRIPE_WEBHOOK_SECRET 可选密钥 Stripe webhook 签名密钥（whsec_...），由 stripe listen 或 Dashboard webhook 端点提供。

其他可选配置项（6 个）

OAUTH_OPEN_DCR_ENABLED 可选开关动态客户端注册（DCR）；开启后未验证客户端被限制在 DCR_ALLOWED_SCOPES 内。

DCR_ALLOWED_SCOPES 可选自注册 OAuth 客户端允许的最大 scope 集合，在服务端配置中设置。

NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY 可选 Stripe 可发布密钥（pk_test_...），从 Stripe 控制台获取。

STRIPE_PRICE_PRO 可选 Pro 计划的价格 ID，由 pnpm stripe:setup 自动写入 .env。

STRIPE_PRICE_ENTERPRISE 可选 Enterprise 计划的价格 ID，由 pnpm stripe:setup 自动写入 .env。

STRIPE_PORTAL_CONFIG_ID 可选 Stripe Customer Portal 配置 ID，由 pnpm stripe:setup 自动写入 .env。

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

验证是否装好

在客户端（如 Claude Code 或 Cursor）中添加 MCP URL（服务的 /mcp 端点，Streamable HTTP），完成 OAuth 同意或提供 API 密钥后，客户端工具列表中应出现从 OpenAPI 文档派生、按调用者 scope 过滤的工具。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

连接到我的 MCP 服务器 /mcp 并列出我有权限调用的工具
使用我的 API 密钥通过 OAuth 连接此 MCP 端点并调用一个只读的 API 工具
从 OpenAPI 文档派生的工具中调用一个端点，把返回结果展示给我

工具能力 1

mcp_server

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

使用场景

为你的 SaaS 应用提供 AI 代理集成，允许它们执行 API 操作（如管理资源）

将 MCP 服务器作为模板的远程 MCP 端点，供 Claude Code、ChatGPT、Cursor 等客户端使用

支持客户端

Claude Code

Claude.ai

ChatGPT

Cursor

VS Code

Codex

Antigravity

Grok CLI

依据项目文档列出，未经本站实测。

详细介绍

这是一个开源的 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 密钥进行认证。