Skip to content

feat(mcp): add personal OAuth authorization for remote MCP servers - #304

Draft
duhu2000 wants to merge 3 commits into
OpenBMB:mainfrom
duhu2000:feat/mcp-oauth
Draft

duhu2000 wants to merge 3 commits into
OpenBMB:mainfrom
duhu2000:feat/mcp-oauth

Conversation

@duhu2000

@duhu2000 duhu2000 commented Nov 4, 2026 •

Copy link
Copy Markdown

目的与行为

为已保存的远程 MCP Server 增加个人 OAuth 授权,用户无需复制 API Key。此 PR 是通用能力;企查查统一入口卡片已单独提交为 #305,依赖本 PR。

  • 资源元数据发现(含 path → root 404 回退)、公开客户端动态注册、授权码 + PKCE S256、一次性 state 和十分钟有效期。
  • 按租户/用户/Server 隔离并加密持久化凭据;刷新令牌轮换、重启读取、资源地址变更阻断令牌复用。
  • 已保存服务的发现/同步、MCP Apps 资源读取、工具调用使用当前用户的凭据;Harness 从已保存聊天会话解析用户。
  • 明显的授权链接和复制链接按钮,提示在系统浏览器打开,不依赖自动弹窗。状态轮询仅在等待授权时运行。
  • 本地解绑与可选远端撤销,删除 Server 清理本地凭据。内置/stdio/原有静态 Header 连接方式保持兼容。

范围与限制(请求先评审架构)

当前为 Draft:尚未完成正式桌面安装包、管理员/普通成员浏览器流程和真实短信 OAuth 验收;没有发起付费查询。不是已完成产品验收的声明。

支持 DCR + public PKCE 客户端;不含预注册 confidential client 配置。刷新锁仅单进程,沿用现有 SQLite runtime lock;不支持分布式刷新。提前失效的 401 需要重新授权,不自动重放业务调用。请在部署中配置稳定强密钥 APP_SECRET、正确 TOOL_BASE_URL,并在代理访问日志中隐藏 callback query。详细边界见 MCP_OAUTH.md。

验证

  • 后端 OAuth、存储、MCP server API、ToolExecutor、stdio、错误脱敏:59 passed。
  • 前端 McpOAuthControl:3 passed(授权链接、失败状态、解绑状态)。
  • TypeScript/Vite production build、i18n:check、config:check、git diff --check 通过。
  • 新增 OAuth Python 文件 Ruff 通过;未宣称全仓库 Ruff 通过,现有 tools/main 等文件仍有基线 lint 问题。
  • 测试包含并发刷新、令牌隔离、重启持久化、state 防重放和 Harness 会话用户选择,均使用本地 mock provider。

未上传账号、凭据、原始查询结果或用户截图。欢迎维护者评审 API/凭据隔离/回调方案;确认路线后再补正式产品验收并转 Ready。

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant