From 8ac62bedd9ac228791c222e3777d740375824287 Mon Sep 17 00:00:00 2001 From: kicer Date: Fri, 4 Sep 2026 20:50:59 +0800 Subject: [PATCH] =?UTF-8?q?mcp:=20=E5=85=BC=E5=AE=B9=20session=20=E8=BF=87?= =?UTF-8?q?=E6=9C=9F=EF=BC=8C=E8=87=AA=E5=8A=A8=E9=87=8D=E6=96=B0=E6=8F=A1?= =?UTF-8?q?=E6=89=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 某些 MCP 服务在长时间空闲后会主动让旧 session 失效,下次非 initialize 请求会返回 400 并提示 missing/invalid Mcp-Session-Id。之前 mcp.js 一直 复用启动时缓存的 server.sessionId,会持续报错。 本次在 rpc() 出口处加一个最小补偿:仅当 method 不是 initialize、状态码 是 400、错误体含 'session' 时,清掉旧 id、重新跑 initialize + notifications/initialized、再重试一次原请求。initialize 调用走当前函数 的 method !== 'initialize' 分支天然不会带旧 header,递归链路自动终止 在 initialize 那一层(不会无限循环)。 工具表(toolDefs / toolIndex)保持 init() 时的快照不变——session 重连 只换 id,不动工具表,避免工具集差异导致调用方混淆。重连失败或重连后 仍然 400 时原样向上抛错,由调用方决定如何应对。 --- app/server/mcp.js | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/app/server/mcp.js b/app/server/mcp.js index 85baeaf..694d896 100644 --- a/app/server/mcp.js +++ b/app/server/mcp.js @@ -15,6 +15,7 @@ let builtinNames = new Set(); // 发一次 JSON-RPC 请求,返回 { result, headers }(HTTP 非 2xx / error / 无法解析时抛异常)。 // 某些 MCP 服务遵循 Streamable HTTP 规范会在 initialize 响应里返回 Mcp-Session-Id, // 之后所有非 initialize 请求都必须带上该 header,否则返回 400。我们把会话 id 缓存在 server.sessionId 里。 +// session 过期补偿:非 initialize 请求若 400 且错误信息含 session,清掉旧 id 并重新 initialize 后重试一次。 async function rpc(server, method, params, timeoutMs) { const callId = Date.now(); const ctrl = new AbortController(); @@ -36,7 +37,31 @@ async function rpc(server, method, params, timeoutMs) { // 响应头里出现 Mcp-Session-Id 就缓存到 server(多处出现都被覆盖为最后一次,重复请求同一服务后保持一致) const sid = res.headers.get('mcp-session-id'); if (sid) server.sessionId = sid; - if (!res.ok) throw new Error('HTTP ' + res.status + ': ' + raw.slice(0, 300)); + if (!res.ok) { + // session 过期补偿:仅对非 initialize 请求,400 且错误信息含 session 时重新握手后重试一次。 + // 不调 tools/list —— 工具表在 init() 时已经发现并固化,运行期间不需要重新发现。 + if (method !== 'initialize' && res.status === 400 && /session/i.test(raw)) { + clearTimeout(timer); + log.warn('[mcp] ' + server.name + ' session 疑似过期,重新握手: ' + raw.slice(0, 200)); + server.sessionId = null; + // 重新跑 initialize,递归走当前函数,method=initialize 不会再触发重连逻辑 + try { + await rpc(server, 'initialize', { + protocolVersion: '2024-11-05', + capabilities: {}, + clientInfo: { name: 'agent', version: '1.0.0' }, + }, 15000); + // 按 MCP 规范发 notifications/initialized(无响应体,失败不阻断) + try { await rpc(server, 'notifications/initialized', {}, 5000); } catch (_) { /* 通知失败不阻断 */ } + } catch (e) { + // 老服务可能没有 initialize,会报 Method not found;不阻断,按既有兼容走原通道 + if (!/Method not found/i.test(String(e && e.message || e))) throw e; + } + // 重试原请求(新一次 fetch + 新 AbortController) + return await rpc(server, method, params, timeoutMs); + } + throw new Error('HTTP ' + res.status + ': ' + raw.slice(0, 300)); + } // 响应可能是 SSE 帧(多行 data: {...}),取 id 匹配或最后一条 JSON let payload = null; try {