模型上下文协议（MCP）服务器+管理员OAuth
这是一个 模型上下文协议（MCP） 支持远程MCP连接的服务器，内置Clerk OAuth。
您可以将其部署到自己的Cloudflare帐户，在创建自己的Clerk OAuth应用程序后，您将拥有一个功能齐全的远程MCP服务器，您可以在其上构建。用户将能够通过使用Clerk登录连接到您的MCP服务器。
您可以使用此示例作为参考，了解如何将其他OAuth提供程序与部署到Cloudflare的MCP服务器集成，使用 workers-oauth-provider 图书馆.
MCP服务器（由 Cloudflare员工):
- 充当OAuth _服务器_ 您的MCP客户
- 充当OAuth _客户端_ 给你的 _真实的_ OAuth服务器（在本例中为Clerk）
\[！警告\] 这是一个演示模板，旨在帮助您快速入门。虽然我们已经实施了几种安全控制， 在部署到生产环境之前，您必须实施所有预防性和深度防御安全措施。请查看我们的综合安全指南： 保护MCP服务器
入门指南
直接克隆仓库并安装依赖项： npm install.
或者，您可以使用下面的命令行在本地计算机上创建远程MCP服务器：
npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-clerk-oauth生产环境
创建新的Clerk应用程序和OAuth配置：
- 注册或登录 职员仪表板
- 创建新应用程序
- 首选 OAuth应用程序 并创建一个新的OAuth应用程序
- 将重定向URI设置为：
https://mcp-clerk-oauth..workers.dev/callback - 记下您的客户端ID和客户端密码
- 从获取密钥 API密钥 （开始于
sk_live_) - 请注意您的前端API URL（例如。，
https://your-subdomain.clerk.accounts.dev)
通过牧马人设置秘密：
wrangler secret put CLERK_CLIENT_ID
wrangler secret put CLERK_CLIENT_SECRET
wrangler secret put CLERK_SECRET_KEY
wrangler secret put CLERK_FRONTEND_API
wrangler secret put COOKIE_ENCRYPTION_KEY # generate with: openssl rand -hex 32\[！重要\] 当你创建第一个秘密时，牧马人会询问你是否要创建一个新的Worker。提交“Y”以创建新的Worker并保存密钥。
设置KV命名空间
- 创建KV命名空间：
wrangler kv namespace create "OAUTH_KV"
- 使用KV ID更新牧马人文件
部署和测试
部署MCP服务器，使其在workers.dev域上可用 wrangler deploy
使用测试远程服务器 检查员:
npx @modelcontextprotocol/inspector@latest进入 https://mcp-clerk-oauth..workers.dev/mcp （或 /sse 对于已弃用的协议），然后点击连接。完成身份验证流程后，您将看到工具正在工作：
您现在已经部署了远程MCP服务器！
访问控制
此MCP服务器使用Clerk OAuth进行身份验证。所有经过身份验证的用户都可以访问“添加”和“用户信息”等基本工具。
“generateImage”工具仅限于使用基于角色的访问控制（RBAC）的特定角色：
// Roles that have access to the image generation tool
const ALLOWED_ROLES = new Set([
'admin',
'premium'
]);要在职员仪表板中设置用户的角色，请执行以下操作：
- 首选 用户 → 选择用户
- 点击 元数据 标签
- 在...之下 公共元数据，添加：
{"role": "admin"} - 保存更改
从Claude Desktop访问远程MCP服务器
打开克劳德桌面，导航到设置->开发人员->编辑配置。这将打开控制Claude可以访问哪些MCP服务器的配置文件。
用以下配置替换内容。重新启动Claude Desktop后，将打开一个浏览器窗口，显示您的OAuth登录页面。完成身份验证流程，授予Claude访问您的MCP服务器的权限。授予访问权限后，这些工具将可供您使用。
{
"mcpServers": {
"clerk-mcp": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-clerk-oauth..workers.dev/mcp"
]
}
}
}一旦工具（下🔨) 在界面中显示，您可以要求Claude使用它们。例如：“你能用数学工具把23和19相加吗？”。Claude应该调用该工具并显示MCP服务器生成的结果。
促进地方发展
如果你想迭代和测试你的MCP服务器，你可以在本地开发中这样做：
- 在职员仪表板中，更新OAuth应用程序的重定向URI以包含
http://localhost:8788/callback - 复制
.env.example到.env并填写您的职员凭证：
CLERK_CLIENT_ID=your_clerk_client_id
CLERK_CLIENT_SECRET=your_clerk_client_secret
CLERK_SECRET_KEY=sk_test_...
CLERK_FRONTEND_API=https://your-subdomain.clerk.accounts.dev
COOKIE_ENCRYPTION_KEY=开发和测试
在本地运行服务器，使其在以下位置可用 http://localhost:8788
npm run dev # or: wrangler dev要测试本地服务器，请输入 http://localhost:8788/mcp （或 /sse 对于已弃用的协议）进入Inspector并点击连接。按照提示操作后，您将能够“列出工具”。
使用Claude和其他MCP客户端
使用Claude连接到远程MCP服务器时，您可能会看到一些错误消息。这是因为Claude Desktop还不支持远程MCP服务器，所以有时会感到困惑。要验证MCP服务器是否已连接，请将鼠标悬停在🔨 克劳德界面右下角的图标。你应该在那里看到你的工具。
使用游标和其他MCP客户端
要将Cursor与MCP服务器连接，请选择 Type：“命令”和 Command 字段，将命令和args字段组合成一个（例如。 npx mcp-remote https://..workers.dev/sse).
请注意，虽然Cursor支持HTTP+SSE服务器，但它不支持身份验证，因此您仍然需要使用 mcp-remote （并且使用STDIO服务器，而不是HTTP服务器）。
您可以通过打开客户端的配置文件，添加用于Claude设置的相同JSON，并重新启动MCP客户端，将MCP服务器连接到其他MCP客户端，如Windsurf。
它是如何工作的？
OAuth提供者
OAuth Provider库是Cloudflare Workers的完整OAuth 2.1服务器实现。它处理OAuth流的复杂性，包括令牌发放、验证和管理。在这个项目中，它扮演着双重角色：
- 对连接到服务器的MCP客户端进行身份验证
- 管理与Clerk的OAuth服务的连接
- 在KV存储器中安全存储令牌和身份验证状态
耐用MCP
Durable MCP通过Cloudflare的Durable Objects扩展了基本MCP功能，提供：
- MCP服务器的持久状态管理
- 请求之间身份验证上下文的安全存储
- 通过以下方式访问经过身份验证的用户信息
this.props - 支持基于用户身份的有条件工具可用性
MCP远程
MCP Remote库使您的服务器能够公开可由MCP客户端（如检查器）调用的工具。它
- 定义客户端和服务器之间的通信协议
- 提供了一种结构化的方法来定义工具
- 处理请求和响应的序列化和反序列化
- 维护客户端和服务器之间的服务器发送事件（SSE）连接