MCPHub 更新日志
MCPHub 开源产品的版本发布记录,内容来自 GitHub Releases。
v1.2.6
2026年11月18日MCPHub v1.2.6 新增本地账户通行密钥登录、OpenAPI 服务器个人 OAuth,以及 HTTP 监听地址配置。
- 支持 OpenAPI 服务器使用个人 OAuth 授权
- 支持本地账户使用通行密钥(WebAuthn)登录
- 新增 MCPHUB_HOST,用于配置 HTTP 监听地址
功能修复查看版本v1.2.5
2026年11月16日v1.2.5 新增默认关闭的 OpenAI 兼容工具名称选项,并首次交付针对已配置 stdio 工具的文件暂存后端/API。
- 在系统设置中新增 OpenAI 兼容工具名称选项,默认关闭;修改后需重新连接客户端。
- 为已配置的 stdio 工具提供可选文件暂存能力,包含上传、状态查询和下载工具。本次交付后端/API,浏览器上传界面和智能路由集成将在后续实现。
- 修复上游列表未变化时反复触发列表变更通知的问题。
功能修复查看版本v1.2.4
2026年11月14日本版本改进了上游 MCP 能力发现、数据库恢复及导入 OpenAPI 工具的兼容性。
- 发现上游工具、提示词、资源及资源模板的所有分页,确保后续页面中的能力可用。
- 为数据库重连初始化和清理设置超时,隔离延迟完成的操作,并保持恢复期间的健康探针可响应。
- 规范化导入 OpenAPI 中允许空值的输入 schema,同时保留必填字段和校验约束。
修复查看版本v1.2.3
2026年11月11日本版本新增个人 API Key 的分组范围控制,便于精细限制 Agent 的访问权限,并改进上游兼容性和故障恢复。
- 支持将个人 API Key 限制为仅访问选定分组,并在控制台提供范围设置;现有不受限密钥保持原有行为。
- 当 URI 未列入静态资源列表时,通过匹配的上游资源模板路由 resources/read 请求,并遵守分组资源选择限制。
- 当缺失个人 OAuth 授权导致工具发现无可用工具时,返回包含明确处理提示的授权错误。
功能修复查看版本v1.2.2
2026年11月7日MCPHub v1.2.2 新增个人凭据复制、可选的 OAuth 授权记忆和应用授权撤销,让凭据与应用访问更易管理。
- 支持在兼容服务器之间复制个人凭据,覆盖前需确认,复制后的凭据独立保存。
- 支持从自定义请求头读取转发认证 JWT,适配 Cloudflare Access 等场景。
- 可选择记忆 OAuth 授权,并允许用户撤销已授权应用;默认仍在每次授权时要求确认。
功能修复查看版本v1.2.1
2026年11月3日MCPHub v1.2.1 改进上游连接稳定性和 OpenAPI 参数兼容性,新增精确限定范围的 Fake-IP 例外,并允许管理员显式启用 Authorization 透传。
- 新增由管理员管理的 Fake-IP 例外,按上游服务器和精确主机名限定 SSE 与 Streamable HTTP 连接。
- 在 Docker 部署指南中补充一键部署选项。
- 通过管理员显式启用恢复上游 Authorization 透传,默认关闭;需配置独立的 MCPHub 认证请求头及可信上游,托管模式仍不支持。
功能修复查看版本
展开更早的版本(24)
v1.2.0
2026年11月1日v1.2.0 新增实验性集群支持,通过显式启用的 PostgreSQL 多副本模式,让多个 MCPHub 实例在负载均衡器后共享配置与凭据,并提供配置同步、跨节点 OAuth 协调、就绪检查和 HTTP 优雅排空。
- 实验性集群 / 多副本模式(默认关闭): 设置 MCPHUBREPLICAMODE=true,即可让多个实例共享 PostgreSQL。配置变更每五秒同步,拒绝基于过期配置的写入,并跨节点协调 OAuth 状态、授权码消费与凭据刷新。
- 部署与运维支持: 提供 Docker Compose 和 Kubernetes 示例,包含独立建库、双副本与负载均衡会话亲和性配置;增加存活/就绪检查、节点与配置诊断、指标及 HTTP 优雅排空。各副本需共享持久化 JWT 密钥与凭据加密密钥,单独执行表结构准备,并在服务节点设置 DB_SYNCHRONIZE=false。详见多副本部署指南。
- 实验性能力边界: MCP 会话、隔离上游客户端、Cookie 状态与本地文件仍属于单个进程。有状态客户端需要粘性路由,节点丢失后需重新初始化;执行中的调用不会迁移或重放。PostgreSQL 与负载均衡器的高可用仍由部署方保障。建议先在测试环境评估,再决定是否用于生产。
功能修复查看版本v1.1.15
2026年10月31日MCPHub v1.1.15 新增用户组共享、更灵活的系统 Bearer Key 权限范围、个人凭据脱敏预览,以及可选的私有代理 OAuth 授权中继。
- 支持向管理员维护的用户组共享服务器和 Group 路由,继续遵循底层服务器权限与工具策略。
- 在自己的 Credentials 页面通过脱敏预览识别已保存的个人凭据。
- 支持为显式配置的私有代理启用个人 OAuth 授权中继,并限制允许的 HTTPS 重定向来源。
功能修复查看版本v1.1.14
2026年10月29日v1.1.14 让 MCPHub 更易于治理,在真实部署中也更稳定。
- 统一实施 MCP 工具访问策略,并为管理员提供「设置 → 工具访问策略」编辑器。
- 管理员可在凭据页面与用户页面为其他用户预置、查看状态、替换和删除个人凭据。
- 管理员可自定义控制台名称,并立即应用到侧边栏、页头、登录页和浏览器标签页。
功能修复查看版本v1.1.13
2026年10月28日本版本支持在保留权限的同时重置 Bearer 密钥,并改进个人凭据绑定迁移及嵌入模型服务的兼容性。
- 支持在保留权限的同时重置 Bearer 密钥
- 校验并独立迁移个人凭据绑定
- 在运行时协商嵌入编码格式,提升服务提供商兼容性
功能修复查看版本v1.1.12
2026年10月27日本版本增强个人凭据和 Bearer Key 的存储安全性,客户端已有令牌继续有效。
- 个人凭据(#1393): 数据库模式不再自动生成本地加密密钥,需配置 MCPHUBCREDENTIALENCRYPTION_KEY 或保留已有的有效密钥文件;升级和多实例部署必须使用同一密钥。密钥丢失后,仅有数据库备份无法恢复绑定。正常部署的升级步骤及密钥丢失后的处理方案见升级与恢复指南。
- Bearer Key(#1387): 改为保存 SHA-256 哈希,启动时自动迁移已有明文密钥。客户端已有令牌继续有效,新建令牌仅在创建时返回一次。迁移后不可直接用旧版本读取已迁移的数据库/配置,回滚需恢复升级前备份。 从文件模式切换到数据库模式时,应先以文件模式运行新版本一次,或清除源配置文件遗留的明文密钥。
修复查看版本v1.1.11
2026年10月27日MCPHub v1.1.11 通过默认协商现代 HTTP、支持显式 OAuth 授权服务器元数据和自动后台重连,改善上游兼容性与连接稳定性。
- 在分组及分组智能路由中支持选择保留上游原始工具名称,并检查名称冲突。
- 支持为共享及个人上游连接配置显式 OAuth 授权服务器元数据。
- 重启后恢复按需 stdio 服务器上次发现的工具目录,配置匹配时无需启动上游。
功能修复查看版本v1.1.10
2026年10月24日MCPHub v1.1.10 将协商后的 MCP 协议版本与服务器软件版本分开展示,方便查看上游连接信息。
- 在传输方式旁显示各上游 MCP 服务器协商后的协议版本,与软件版本分开展示。
- 优化服务器列表行布局,避免 Token 统计与控件重叠,并减少服务器名称被截断的情况。
- 在展开的服务器卡片中显示完整描述,支持自动换行。
功能修复查看版本v1.1.9
2026年10月23日MCPHub v1.1.9 让大型服务器更易管理:支持对工具、提示词和资源进行可搜索的批量处理并新增批量状态 API,同时通过个人 URL 凭据槽位让 HTTP 服务器在区域或租户端点之间共用同一份定义。
- 新增越南语界面
- 为 HTTP 服务器新增个人 URL 凭据槽位
- 为隔离的旧版工具调用转发用户输入征求
功能修复查看版本v1.1.8
2026年10月21日MCPHub v1.1.8 新增可选开启的本地账号自助注册和按工具隐藏输入参数的功能,同时加快连接状态反馈,避免无关的服务器编辑影响个人 OAuth 绑定,展示服务端报告的版本,并更新 MCP SDK、Hono 和 Vite 依赖。
- 新增可选开启的本地账号自助注册
- 支持按工具隐藏输入 schema 中的参数
- 无 runner 包版本时展示服务端报告的版本
功能修复查看版本v1.1.7
2026年10月19日MCPHub v1.1.7 新增供 MCP 客户端使用的分组指令、可选的 Prometheus 指标、声明式配置的托管条目清理,以及可主动启用的高风险工具调用参数防护。
- 支持配置在 MCP 初始化时返回的分组指令,覆盖智能分组路由和多服务器分组。
- 通过 ENABLEMETRICS=true 启用 Prometheus 指标;可使用独立的 METRICSTOKEN Bearer 凭据保护 /metrics。
- 通过 MCPHUBSETTINGSSYNC=prune,在启动时永久删除已从配置中移除的托管服务器和分组,同时保留非托管的控制台条目。
功能修复查看版本v1.1.6
2026年10月18日本版本支持自定义智能路由路径,并继续兼容现有 $smart URL。
- 通过 SMARTROUTINGPATH 自定义智能路由端点,继续支持现有 $smart URL。
- 在市场和注册表中为非管理员禁用本地命令安装并显示原因,保留受支持的远程安装。
- OAuth 仅包含默认共享身份设置时允许使用凭据槽,并在重命名受影响的旧服务器配置时保留凭据绑定。
功能修复查看版本v1.1.5
2026年10月16日MCPHub v1.1.5 新增西班牙语界面,并改进 API 参数校验与工具列表同步。
- 新增西班牙语(es)界面,可在语言菜单中选择 Español。
- 当服务器列表请求的 page 或 limit 参数为非数字时,返回 HTTP 400。
- 从分组移除服务器后通知工具监听器,使已连接的客户端能够刷新工具列表。
功能修复查看版本v1.1.4
2026年10月15日v1.1.4 扩展了上游服务的个人身份认证能力,支持独立的 OAuth 连接和 stdio 参数中的个人凭据槽位,同时改进 OAuth 服务发现、聚合工具路由和 Windows 兼容性。
- 支持个人上游 OAuth 绑定,提供逐用户独立授权和仪表盘连接管理。
- 支持通过显式 {{args.API_KEY}} 占位符在 stdio 参数中使用个人凭据槽位。
- 发布与端点路径对应的 OAuth 受保护资源元数据及匹配的认证质询。
功能修复查看版本v1.1.3
2026年10月11日MCPHub v1.1.3 新增由管理员配置的上游访问 CIDR 白名单,并改善 CLI 工具调用、空闲按需启动服务器的 MCP Apps 小组件,以及 ChatGPT Work/Codex 中有状态工具的兼容性。
- 支持管理员通过设置页面或 systemConfig.network.allowedCidrs 配置允许上游访问的 IPv4/IPv6 CIDR 网段。
- CLI 工具调用前初始化 MCP 会话,修复因缺少会话 ID 导致的 HTTP 400 错误。
- 读取 ui:// 小组件时唤醒空闲的按需启动服务器,避免提前返回“Resource not found”错误。
功能修复查看版本v1.1.2
2026年10月8日MCPHub v1.1.2 新增基于 JWKS 的转发认证,并支持在智能路由分组端点上为固定工具展示 MCP Apps 小组件。
- 为仪表盘 API 和 MCP 传输新增基于 JWKS 的转发认证。
- 保留 $smart/{group} 固定工具的 MCP Apps 元数据,让兼容客户端能够展示小组件。
- 当工具已缓存或运行实例不再满足执行条件时,取消排队的按需发现任务,避免重复启动服务器进程。
功能修复查看版本v1.1.1
2026年10月7日本版本重点加强部署安全与精简模型上下文。
- SSO 部署可关闭用户名/密码登录(betterAuth.disablePasswordLogin),消除较弱的第二登录入口,并可用 BETTERAUTHDISABLEPASSWORDLOGIN 在身份提供商故障时恢复
- 可配置 searchtools 与 describetool 返回的 MCP 工具字段(smartRouting.toolDefinitionFields),新的 title + annotations 默认值使典型搜索结果体积减少约一半
- 数据库模式下可通过 MCPHUBSETTINGSSYNC=upsert 在每次启动时同步声明式 mcp_settings.json 中的服务器与分组
功能修复查看版本v1.1.0
2026年10月3日v1.1.0 标志着 #1220 所跟踪的 MCP 2026-07-28 分阶段迁移完成双协议基线与既定验收检查。
- 当上游发现结果的有效期可信时,为现代工具、提示词、资源和资源模板列表提供正值私有缓存 TTL;上限取各上游剩余有效期与网关五秒预算中的最小值。有效期不确定时,TTL 保持为零。
- 补充有上限的正值列表 TTL 策略文档,以及旧版 SSE 的弃用与迁移规划。 by @samanhappy in https://github.com/samanhappy/mcphub/pull/1276 and https://github.com/samanhappy/mcphub/pull/1275
- 防止现代请求继承旧会话的分组作用域,改为依据请求 URL 和认证上下文路由,同时保留旧客户端的会话延续行为。
功能修复查看版本v1.0.46
2026年10月3日本版本加强服务配置隔离,为现代 MCP 客户端增加保守的缓存提示,并改善管理界面的参数编辑和可读性。
- 为现代 MCP 响应增加私有缓存范围和保守的 TTL 提示。
- 完善 MCP 协议兼容性与迁移文档,并说明 PostgreSQL 连接池容量的计算方式。
- 根据所有者的实时权限隔离服务配置中的环境变量展开,覆盖 HTTP/SSE 请求头和重连路径(GHSA-547h-r8jj-9wmc)。
功能修复查看版本v1.0.45
2026年10月2日MCPHub v1.0.45 改进了 REST 工具调用结果的完整性、OpenAPI 参数处理,以及无状态客户端的 MCP Apps 兼容性。
- 保留完整的 REST 工具调用结果,包括结构化输出、工具错误和元数据,
- 将 OpenAPI 路径级参数纳入生成的工具,并支持操作级参数覆盖,
- 根据每次请求声明的客户端能力,为兼容的无状态客户端启用 MCP Apps,
修复查看版本v1.0.44
2026年9月30日本版本通过 X-MCPHub-State-Id,让已认证的现代 MCP 客户端能够为依赖会话状态的工具复用隔离状态,修复 SDK v2 迁移后的上游 OAuth 授权回调,并完善路由兼容性测试与贡献指南。
- 支持通过客户端生成的 UUID v4 X-MCPHub-State-Id,在现代 MCP 请求之间复用隔离的上游连接和 OpenAPI Cookie 状态。状态绑定到认证凭据、用户和路由,并在闲置 30 分钟后过期。
- 恢复持久化的 OAuth 发现状态并传递回调签发者信息,修复 SDK v2 迁移后的授权码交换失败。未保存发现状态的已有授权流程需要重新发起。
- 修正贡献指南中不存在的命令和文件路径。
功能修复查看版本v1.0.43
2026年9月30日MCPHub v1.0.43 为 MCP 2026-07-28 请求新增双栈 HTTP 路径,同时保留旧版 Streamable HTTP 行为。
- 为 MCP 2026-07-28 请求新增无状态 HTTP 路径,与旧版 Streamable HTTP 并存;对依赖会话状态的上游服务支持仍有限。
- 为 search_tools 结果显示评分,支持配置相似度阈值,明确提示无匹配结果,并限制仅前 N 个结果返回完整工具定义。
- 在分组的 $smart 端点中,将选定工具与元工具一同固定展示。
功能修复查看版本v1.0.42
2026年9月28日MCPHub v1.0.42 升级至 MCP SDK v2.1,同时保留旧版协议兼容性;修复工具调用重连时的环境变量展开问题,并恢复与未声明支持颁发者响应参数的上游服务器的 OAuth 兼容性。
- 在工具调用重连前展开服务器配置中的环境变量,确保 SSE 和 Streamable HTTP 重试使用预期的 URL 和凭据。
- 移除阻塞页面渲染的 Google Fonts 依赖,Dashboard 改用系统字体。
- 修正智能路由文档,使用 DBPOOLSIZE 并移除不受支持的 DATABASE_TIMEOUT。
修复查看版本v1.0.41
2026年9月26日这个版本让智能路由更灵活也更透明。
- 在市场(Marketplace)中隐藏 Cloud Support(MCPRouter)标签页
- 为智能路由新增可选的嵌入查询与文档前缀
- 持久化通过系统配置 API 设置的服务器描述模式(serverDescriptionMode)
功能修复查看版本v1.0.40
2026年9月24日这个版本让智能路由(Smart Routing)更可观测,也让服务在高并发下更稳定。
- 新增智能路由性能诊断与强制重建索引 API,并提供仪表盘面板
- 加固数据库重连与热路径,防止连接池卡死:为销毁、健康检查与连接设置超时上限
- 保留安全的上游失败诊断信息,不再把传输层与工具调用错误误判为凭据问题
功能修复查看版本