模型上下文协议（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-server-demo-github-auth..workers.dev - 对于授权回调URL，请指定
https://mcp-server-demo-github-auth..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-server-demo-github-auth..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-server-demo-github-auth..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）连接