MCP 服务支持配置单次工具调用超时(mcp_servers[].timeout_ms)

原来 tools/call 的 60s 写死在 mcp.js,对搜索和图/视频生成这类耗时差一个数量级的服务没法兼顾。现按服务配置:config.js 归一化缺省 60s、夹在 1s~10min(YAML 写成字符串也吃,非法值回落缺省),callTool 取 server.timeout_ms。

只管 tools/call:initialize 与 tools/list 仍是固定 15s(协议往返,与服务快慢无关,放大了只会拖慢启动)。上限 10min 的理由是一次工具调用独占一个模型槽位,不允许无限等。

另:rpc() 把超时错误从原生的 This operation was aborted 改为带配置毫秒数与 method 的信息——超时既然可配了,排查时得看得出当时生效的是多少。

文档跟进:config.example.yml 示例与说明、app/README 服务字段清单、ARCHITECTURE 第 9 节与 11.3 扩展点。前端 MCP 编辑页暂未加该字段(改已有服务走逐字段 setIn,手写的 timeout_ms 不会被覆掉)。
This commit is contained in:
2026-09-17 22:00:21 +08:00
parent 9c2f702691
commit 9deebe8883
5 changed files with 36 additions and 8 deletions
+20 -4
View File
@@ -1,5 +1,5 @@
// 极简 MCP 客户端(Streamable HTTP:JSON-RPC over HTTP,无状态,响应可能是 SSE 帧包裹的 JSON)。
// MCP 服务在 config.yml 的 mcp_servers 中配置(可多个):{name?, url, headers?, enable?}。
// MCP 服务在 config.yml 的 mcp_servers 中配置(可多个):{name?, url, headers?, enable?, timeout_ms?}。
// 启动时 init() 对每个服务调 tools/list 发现工具(enable: false 的服务跳过加载),转成 OpenAI function 格式,
// 追加在内置工具(definitions.json)之后一起随 system prompt 发给模型;
// 工具调用经 tools/call 转发给对应服务。
@@ -8,6 +8,10 @@
const log = require('./log');
// 单次 tools/call 的缺省最大等待;服务配了 timeout_ms 就用服务的(config.js 已归一化)。
// 与 config.js 的 MCP_CALL_TIMEOUT_MS 保持一致。
const CALL_TIMEOUT_MS = 60000;
let toolDefs = []; // OpenAI function 格式(所有 MCP 工具)
const toolIndex = new Map(); // 发送名 -> { server, tool }(服务配置 + 原始工具名)
let builtinNames = new Set();
@@ -18,8 +22,12 @@ let builtinNames = new Set();
// session 过期补偿:非 initialize 请求若 400 且错误信息含 session,清掉旧 id 并重新 initialize 后重试一次。
async function rpc(server, method, params, timeoutMs) {
const callId = Date.now();
const ms = timeoutMs || 30000;
const ctrl = new AbortController();
const timer = setTimeout(() => ctrl.abort(), timeoutMs || 30000);
// timedOut 用于把 AbortError(原生信息只说 "This operation was aborted")翻成带秒数的超时信息:
// 超时现在是可配的,不印出来的话排查时看不出当时配了多少。
let timedOut = false;
const timer = setTimeout(() => { timedOut = true; ctrl.abort(); }, ms);
try {
const headers = Object.assign({
'Content-Type': 'application/json',
@@ -58,7 +66,7 @@ async function rpc(server, method, params, timeoutMs) {
if (!/Method not found/i.test(String(e && e.message || e))) throw e;
}
// 重试原请求(新一次 fetch + 新 AbortController)
return await rpc(server, method, params, timeoutMs);
return await rpc(server, method, params, ms);
}
throw new Error('HTTP ' + res.status + ': ' + raw.slice(0, 300));
}
@@ -79,6 +87,11 @@ async function rpc(server, method, params, timeoutMs) {
if (!payload) throw new Error('响应无法解析:' + raw.slice(0, 300));
if (payload.error) throw new Error('MCP 错误:' + JSON.stringify(payload.error).slice(0, 500));
return payload.result;
} catch (err) {
// 只有定时器真的触发才改写;其余错误(HTTP 非 2xx、解析失败等)原样上抛。
// 注意 session 重试分支已先 clearTimeout,不会误报成超时。
if (timedOut) throw new Error('MCP 请求超时(' + ms + 'ms):' + method + ' @ ' + server.url);
throw err;
} finally {
clearTimeout(timer);
}
@@ -148,12 +161,15 @@ function toolDefinitions() { return toolDefs; }
function hasTool(name) { return toolIndex.has(name); }
// 把工具调用转发给对应 MCP 服务,返回给模型的文本结果。
// 超时取该服务的 timeout_ms(config.js 里归一化 + 夹过区间);这里再兜一次底,
// 兼容没走配置加载的调用方(如测试里手搓的 cfg)。
async function callTool(name, args) {
const entry = toolIndex.get(name);
if (!entry) return 'Error: 未知 MCP 工具 ' + name;
let result;
try {
result = await rpc(entry.server, 'tools/call', { name: entry.tool, arguments: args || {} }, 60000);
result = await rpc(entry.server, 'tools/call', { name: entry.tool, arguments: args || {} },
Number(entry.server.timeout_ms) || CALL_TIMEOUT_MS);
} catch (err) {
return 'MCP ' + entry.server.name + '/' + entry.tool + ' 调用失败: ' + (err && err.message || err);
}