实现可流式 HTTP 服务器与客户端的 OAuth 支持（无需 PKCE）

概览

此仓库提供：

1. 具备OAuth支持的可流式HTTP服务器（通过设备流程）
2. 具备OAuth支持的可流式HTTP客户端（以无头模式运行）

OAuth 支持

在撰写本文时，我未能使用MCP Inspector测试一个具备OAuth支持的可流式HTTP服务器。这让我走上了通过设备流程实现OAuth的道路。

在典型的基于浏览器的身份验证流程（例如使用MCP Inspector）中：

1. MCP客户端请求与MCP服务器建立连接。
2. 服务器通过GitHubAuthProvider授权客户端（重定向到GitHub）；一旦用户授权所需的范围，服务器的回调处理程序： a. 从GitHub获取访问令牌，然后获取用户数据 b. 在其令牌存储中存储访问令牌和新的会话令牌 c. 为客户端生成临时授权码，并与新生成的会话令牌一起保存 d. 将临时授权码重定向回客户端
3. 客户端使用临时授权码换取会话令牌，用于后续请求

我希望将这种基于浏览器的身份验证流程替换为基于设备的OAuth流程。这将按以下方式工作：

在基于设备的OAuth流程中，我们不需要PKCE，因为：

1. 无需重定向或客户端代码处理。
2. 设备代码流本质上更安全，原因如下：
   • 用户打开URL并在GitHub页面上直接输入代码
   • 所有令牌交换都是服务器对服务器进行的
   • 设备代码本身短暂且只能由请求它的同一客户端（我们的服务器）使用
   • 只有用户代码从服务器传递到客户端

然而，我们仍然没有浏览器用于会话存储。我们可能仍需实现MCP's OAuthServerProvider目前需要的一些方法（例如exchangeAuthorizationCode和challengeForAuthorizationCode）。

使用方法

1. 克隆此仓库。安装依赖项。

npm install

2. 转到您的GitHub开发者设置（在设置下），创建一个OAuth应用。输入“http://localhost”作为回调URL（如果需要）。确保启用'设备流'。注意客户端ID和客户端密钥。

3. 在本地开发环境中设置GITHUB_CLIENT_ID和GITHUB_CLIENT_SECRET环境变量。

4. 启动MCP服务器。

npx tsx server/index_streamable.ts

5. 在另一个终端中启动MCP客户端。

npx tsx client/client.ts