Cloudflare MCP Oauth Template

模型上下文协议（MCP）服务器+Github OAuth

这是一个 模型上下文协议（MCP） 支持远程MCP连接的服务器，内置Github OAuth。

您可以将其部署到您自己的Cloudflare帐户，在您创建自己的Github OAuth客户端应用程序后，您将拥有一个功能齐全的远程MCP服务器，您可以在此基础上构建。用户将能够通过使用他们的Github帐户登录来连接到您的MCP服务器。

您可以使用此示例作为参考，了解如何将其他OAuth提供程序与部署到Cloudflare的MCP服务器集成，使用 workers-oauth-provider 图书馆.

MCP服务器（由 Cloudflare员工):

• 充当OAuth _服务器_ 您的MCP客户
• 充当OAuth _客户端_ 到你的 _真实的_ OAuth服务器（在本例中为GitHub）

入门指南

直接克隆仓库并安装依赖项： npm install.

或者，您可以使用下面的命令行在本地计算机上创建远程MCP服务器：

npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-github-oauth

用于生产

创建新 :

• 对于主页URL，请指定 https://mcp-github-oauth..workers.dev
• 对于授权回调URL，请指定 https://mcp-github-oauth..workers.dev/callback
• 记下您的客户端ID并生成客户端密钥。
• 通过牧马人设置秘密

wrangler secret put GITHUB_CLIENT_ID
wrangler secret put GITHUB_CLIENT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY # add any random string here e.g. openssl rand -hex 32

设置KV命名空间

• 创建KV命名空间：

wrangler kv:namespace create "OAUTH_KV"

• 使用KV ID更新牧马人文件

部署和测试

部署MCP服务器，使其在workers.dev域上可用 wrangler deploy

使用测试远程服务器 检查员:

npx @modelcontextprotocol/inspector@latest

进入 https://mcp-github-oauth..workers.dev/sse 然后点击连接。完成身份验证流程后，您将看到工具正在工作：

您现在已经部署了远程MCP服务器！

访问控制

此MCP服务器使用GitHub OAuth进行身份验证。所有经过身份验证的GitHub用户都可以访问“add”和“userInfoOctokit”等基本工具。

“generateImage”工具仅限于以下列出的特定GitHub用户 ALLOWED_USERNAMES 配置：

// Add GitHub usernames for image generation access
const ALLOWED_USERNAMES = new Set([
  'yourusername',
  'teammate1'
]);

从Claude Desktop访问远程MCP服务器

打开克劳德桌面，导航到设置->开发人员->编辑配置。这将打开控制Claude可以访问哪些MCP服务器的配置文件。

用以下配置替换内容。重新启动Claude Desktop后，将打开一个浏览器窗口，显示您的OAuth登录页面。完成身份验证流程，授予Claude访问您的MCP服务器的权限。授予访问权限后，这些工具将可供您使用。

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-github-oauth..workers.dev/sse"
      ]
    }
  }
}

一旦工具（下🔨) 在界面中显示，您可以要求Claude使用它们。例如：“你能用数学工具把23和19相加吗？”。Claude应该调用该工具并显示MCP服务器生成的结果。

促进地方发展

如果你想迭代和测试你的MCP服务器，你可以在本地开发中这样做。这将要求您在GitHub上创建另一个OAuth应用程序：

• 对于主页URL，请指定 http://localhost:8788
• 对于授权回调URL，请指定 http://localhost:8788/callback
• 记下您的客户端ID并生成客户端密钥。
• 创建一个 .dev.vars 在项目根目录中使用以下文件：

GITHUB_CLIENT_ID=your_development_github_client_id
GITHUB_CLIENT_SECRET=your_development_github_client_secret

开发和测试

在本地运行服务器，使其在以下位置可用 http://localhost:8788 wrangler dev

要测试本地服务器，请输入 http://localhost:8788/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客户端进行身份验证
• 管理与GitHub OAuth服务的连接
• 在KV存储器中安全存储令牌和身份验证状态

耐用MCP

Durable MCP通过Cloudflare的Durable Objects扩展了基本MCP功能，提供：

• MCP服务器的持久状态管理
• 请求之间身份验证上下文的安全存储
• 通过以下方式访问经过身份验证的用户信息 this.props
• 支持基于用户身份的有条件工具可用性

MCP远程

MCP Remote库使您的服务器能够公开可由MCP客户端（如检查器）调用的工具。它

• 定义客户端和服务器之间的通信协议
• 提供了一种结构化的方法来定义工具
• 处理请求和响应的序列化和反序列化
• 维护客户端和服务器之间的服务器发送事件（SSE）连接