← 返回目录

MCP Boilerplate

社区

已归档

框架 / SDK

一个带用户登录和 Stripe 付费工具的远程 Cloudflare MCP 服务器样板。

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

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

分类: 开发工具第 280 / 438
Stars: ★ 1.0k 热门
传输方式: SSE
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 8 个月前 ⚠
工具数: 4

48FMRS · D

这是一个功能全面的 MCP 服务器样板，特别适合在 Cloudflare 上部署远程 MCP 服务器并集成付费功能，但需要用户具备一定的 Cloudflare 和 Stripe 知识。

最强项 · 文档质量 14/20 最弱项 · 维护活跃度 7/20

可靠性

8/20

安全与权限

8/20

维护活跃度

7/20

文档质量

14/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: README 描述了一个结构完整的 Cloudflare Workers MCP 服务器（SSE 端点、Google/GitHub OAuth、KV 会话存储，以及通过 Stripe agent toolkit 注册免费/付费工具），从文档看快乐路径合理且项目是真实存在的样板工程。但本评审仅基于静态材料：证据中没有服务器 manifest、没有已提交的测试、也没有 CI 工作流，无法从源码验证 MCP init/工具列表握手以及所声称的工具是否与真实行为一致；README 还自述最新版 MCP Inspector 不可用，且切换 GitHub 登录需要手工修改源码。因缺少可执行证据、边界情况和错误处理不透明而扣分。
安全与权限 8/20: 凭据处理在纸面上是合理的：本地使用 .dev.vars、生产使用 Cloudflare secrets，README 中的所有示例均为占位符（无真实令牌），OAuth 使用官方重定向 URI，Cookie 使用至少 32 字符的加密密钥；付费必须由用户在 Stripe 托管的结账页面上完成，不存在无确认的自动扣费，因此未触发红线。扣分原因：实际实现无法从所提供证据审查；README 要求以 `as any` 替换认证处理器；Stripe 集成明确标注为 experimental；未讨论最小权限、数据边界、限流或安全响应渠道。
维护活跃度 7/20: 仓库未归档、采用 MIT 许可证，README 提及当前版本（MCP Inspector 0.12.0 与 Stripe agent toolkit），维护者身份明确。但所给材料中无法核实提交/发布历史、变更日志、依赖更新或安全响应渠道；星标数和 issue 数仅作发现信号，不增加分数。因治理与版本管理证据缺失而扣分。
文档质量 14/20: 对一个样板项目而言，README 相当完善且有层次：包含前置条件、Cloudflare KV/OAuth/Stripe 的分步配置、本地与生产部署、客户端接入示例（Claude Desktop、MCP Inspector、Cloudflare AI Playground）、免费/订阅/计量/一次性付费工具模板，以及 Stripe 账单门户的具体排障说明，并披露了已知限制（如最新版 MCP Inspector 不可用）。扣分原因：仅有 README 一个层次，缺少内置工具的参数参考、API/错误/限额文档、架构总览和专门的排障章节，且存在一些隐藏假设。
安装易用性 11/20: README 给出了从克隆到可运行连接的完整有序步骤：安装依赖、创建 KV 命名空间、配置环境变量文件、获取 OAuth 凭据、创建 Stripe 产品、运行 wrangler dev，以及多种客户端的连接示例，命令和文件片段具体可操作。扣分原因：路径本质上是手工且脆弱的——需要配置 Cloudflare、Google/GitHub、Stripe 等多个外部账号，GitHub 登录还需编辑源码才能切换，README 自述最新版 MCP Inspector 无法使用；且没有 CI 或已提交测试提供可验证的执行证据，因此按静态校准上限 15 以下给分。

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

查看 FMRS 评分方法 →

选型与风险

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

适合谁

需要在 Cloudflare 上快速部署远程 MCP 服务器的开发者
希望为 MCP 工具添加付费功能的开发者
需要用户认证的 MCP 项目

不适合谁

需要本地运行的 MCP 服务器
对非 Cloudflare 平台有偏好的开发者
不需要认证或付费功能的简单项目

所需权限

Cloudflare 账户权限
Google 或 GitHub OAuth 权限
Stripe API 密钥权限

风险与副作用

需要妥善保管 API 密钥和加密密钥
Stripe 配置错误可能导致支付流程异常
Cloudflare 部署可能产生费用

安装接入

准备工作

运行环境：Node.js

BASE_URL 必填服务器的基础 URL，本地为 http://localhost:8787，部署后为 workers.dev 域名。

COOKIE_ENCRYPTION_KEY 必填密钥用于加密登录 Cookie 的随机密钥，可用 openssl rand -hex 32 生成。

GOOGLE_CLIENT_ID 必填 Google Cloud Console OAuth 客户端 ID，用于 Google 登录。

GOOGLE_CLIENT_SECRET 必填密钥 Google Cloud Console OAuth 客户端密钥，用于 Google 登录。

GITHUB_CLIENT_SECRET 可选密钥 GitHub OAuth App 的 Client Secret（可选，若改用 GitHub 登录）。

STRIPE_SECRET_KEY 必填密钥 Stripe Dashboard 中 Developers > API keys 下的 Secret key（sk_test_ 开头）。

STRIPE_SUBSCRIPTION_PRICE_ID 必填 Stripe 订阅产品的价格 ID（price_ 开头），用于订阅制付费工具。

STRIPE_METERED_PRICE_ID 必填 Stripe 按量计费产品的价格 ID，用于计量付费工具。

STRIPE_WEBHOOK_SECRET 可选密钥 Stripe Webhook 的签名密钥（whsec_ 开头，可选，仅在使用 Webhook 时需要）。

其他可选配置项（2 个）

GITHUB_CLIENT_ID 可选 GitHub OAuth App 的 Client ID（可选，若改用 GitHub 登录）。

STRIPE_ONE_TIME_PRICE_ID 可选 Stripe 一次性付款产品的价格 ID（可选，用于一次性付费工具）。

克隆仓库，npm install，创建 KV 命名空间 OAUTH_KV，配置 Google/GitHub OAuth，设置 Stripe 密钥，将配置填入 .dev.vars，运行 npx wrangler dev，然后部署。

验证是否装好

运行 npx wrangler dev 启动服务器后，在 Cloudflare AI Playground 或 Claude Desktop 连接 http://localhost:8787/sse 并登录，工具列表中应出现 add、subscriptionAdd、meteredAdd、onetimeAdd，调用 add 输入两个数字应返回求和结果。

常见排障

确保 OAUTH_KV 命名空间名称正确
检查 .dev.vars 中的密钥是否完整
确认 Stripe 产品价格 ID 正确
检查 Cloudflare Worker 的 URL 配置

试试这样问

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

用 add 工具帮我计算 2 加 3 等于多少
通过 subscriptionAdd 工具把 10 和 20 相加
调用 meteredAdd 工具计算 7 加 8 的结果
使用 onetimeAdd 工具计算 100 加 250

工具能力 4

add 只读

免费工具示例：两个数字相加。

subscriptionAdd 只读

付费工具示例：需要订阅才能使用的加法工具。

meteredAdd 只读

付费工具示例：按量计费的加法工具。

onetimeAdd 只读

付费工具示例：一次性付费的加法工具。

使用场景

在 Cloudflare 上托管远程 MCP 服务器

为 MCP 工具添加用户认证

通过 Stripe 实现付费工具

快速搭建 MCP 服务器原型

支持客户端

Claude Desktop

Cursor

Cloudflare AI Playground

MCP Inspector

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

详细介绍

MCP Boilerplate 是一个开源项目，用于在 Cloudflare 上创建远程 MCP 服务器，支持用户登录（Google 或 GitHub）和 Stripe 支付（订阅、按量计费或一次性付费）。它提供了一套简单的分步设置指南，使非技术用户也能上手。