关键词

Clerk身份验证Cloudflare WorkerClaude DesktopJWTAPI代理

使用说明

项目简介

本项目是一个基于Cloudflare Worker构建的MCP（Model Context Protocol）服务器，旨在为Claude Desktop等LLM客户端提供与Clerk身份验证系统集成的能力。通过此MCP服务器，LLM客户端可以安全地访问由Clerk保护的API路由或服务器操作，实现用户身份验证和授权。

主要功能点

  • Clerk身份验证代理: 充当Claude Desktop与Clerk身份验证服务之间的桥梁，代理身份验证请求。
  • 用户模拟: MCP服务器可以模拟Clerk应用中的用户身份，获取用户的JWT（JSON Web Token）。
  • JWT提供: 向LLM客户端返回模拟用户的JWT，客户端可以使用此JWT访问Clerk保护的API资源。
  • 工具函数: 提供 'sayHello' 工具函数，演示如何模拟用户并返回包含JWT的问候消息。
  • MCP协议兼容: 基于 'workers-mcp' 库构建，遵循MCP协议规范，易于与支持MCP协议的LLM客户端集成。

安装步骤

  1. 部署 Cloudflare Worker:

    • 您需要拥有一个Cloudflare账号。
    • 使用 'wrangler' CLI 工具将项目部署到 Cloudflare Workers。 (参考仓库 https://github.com/cloudflare/workers-mcp 中关于 Cloudflare MCP 服务器的部署指南。)
    • 在 Cloudflare Worker 的配置中，设置环境变量 'CLERK_SECRET_KEY' 为您的 Clerk 应用的 Secret Key。这是服务器连接Clerk API所必需的凭据。

  2. 配置 Claude Desktop 客户端:

    • 在 Claude Desktop 客户端中，安装并配置 MCP 服务器连接。
    • 您需要提供 MCP 服务器的配置信息，以便 Claude Desktop 能够连接和调用该服务器的功能。

服务器配置

以下是在 MCP 客户端（如 Claude Desktop）中配置此 MCP 服务器的 JSON 格式信息。请将 '<YOUR_CLOUDFLARE_WORKER_URL>' 替换为您部署的 Cloudflare Worker 的实际 URL。

{
  "serverName": "ClerkAuthMCP",  // MCP 服务器的名称，您可以自定义
  "command": "https://<YOUR_CLOUDFLARE_WORKER_URL>", //  Cloudflare Worker 的 URL，例如： "https://your-worker-name.your-cloudflare-domain.workers.dev"
  "args": [] //  启动参数，此服务器不需要额外的启动参数，保持为空数组即可
}

基本使用方法

  1. 在 Claude Desktop 中，配置并连接到上述配置的 MCP 服务器。
  2. 在 Claude Desktop 的对话框中，您可以尝试调用 'sayHello' 工具函数。例如，输入类似 '"Say hello to [email protected]"' 的指令。
  3. MCP 服务器将尝试模拟邮箱为 '[email protected]' 的 Clerk 用户，并返回一条包含问候语和该用户 JWT 的消息。
  4. 在实际应用场景中，Claude Desktop 可以利用此 JWT 向受 Clerk 保护的 API 发送请求，实现经过身份验证的功能访问。

注意: 此 MCP 服务器主要用于演示和集成 Clerk 身份验证，实际生产环境可能需要根据具体需求进行扩展和安全加固。

信息

分类

网页与API

访问项目