Demo GitHub Auth

MCPAI代理

提供方 Sofiukl · 包名 @modelcontextprotocol/inspector@latest

AI代理 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorWindsurf
查看接入方式

一个支持远程MCP连接并内置GitHub OAuth认证的服务器,可用于构建和扩展MCP工具。

一句话选型结论

按资料字段整理

Demo GitHub Auth 属于AI代理类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP协议TypeScript本地部署GitHubOAuthCloudflareWorkers远程工具认证服务

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector@latest

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Demo GitHub Auth当前 2 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Sofiukl上游标注的维护方 Sofiukl
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/inspector@latest · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.0 KB
来自项目仓库与上游目录的原文,未做删改

模型上下文协议(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服务器:```bash
npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-github-oauth


### 用于生产

创建新 GitHub OAuth应用程序:

- 对于主页URL,请指定 `https://mcp-server-demo-github-auth..workers.dev`
- 对于授权回调URL,请指定 `https://mcp-server-demo-github-auth..workers.dev/callback`
- 记下您的客户端ID并生成客户端密钥。
- 通过牧马人设置秘密```bash
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` 配置:```typescript
// 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)连接

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Demo GitHub Auth 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector@latest。对应的包名是 @modelcontextprotocol/inspector@latest。装完在客户端配置里引用同一个包或端点。

Demo GitHub Auth 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Demo GitHub Auth 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Demo GitHub Auth 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Demo GitHub Auth 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Windsurf;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Demo GitHub Auth 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 认证服务、Cloudflare Workers、Claude。具体工具清单以官方文档为准。

Demo GitHub Auth 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Demo GitHub Auth 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。