From 9deebe888392f723538c97857c48044a400acf7e Mon Sep 17 00:00:00 2001 From: kicer Date: Thu, 17 Sep 2026 22:00:21 +0800 Subject: [PATCH] =?UTF-8?q?MCP=20=E6=9C=8D=E5=8A=A1=E6=94=AF=E6=8C=81?= =?UTF-8?q?=E9=85=8D=E7=BD=AE=E5=8D=95=E6=AC=A1=E5=B7=A5=E5=85=B7=E8=B0=83?= =?UTF-8?q?=E7=94=A8=E8=B6=85=E6=97=B6=EF=BC=88mcp=5Fservers[].timeout=5Fm?= =?UTF-8?q?s=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原来 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 不会被覆掉)。 --- app/README.md | 2 +- app/config.example.yml | 3 +++ app/server/config.js | 12 ++++++++++-- app/server/mcp.js | 24 ++++++++++++++++++++---- docs/ARCHITECTURE.md | 3 ++- 5 files changed, 36 insertions(+), 8 deletions(-) diff --git a/app/README.md b/app/README.md index 43b3656..5b8fc33 100644 --- a/app/README.md +++ b/app/README.md @@ -55,6 +55,6 @@ System prompt 完全静态(所有会话共用,利于上游前缀缓存), - 规划阶段点「开始执行」:追加固定模板消息并切 execution。 - 终止:置位标志 + kill 进程组 + 中止模型流,不再发新请求。 - 所有文件路径解析到任务目录内,拒绝越界。 -- MCP 服务在 config.yml 的 `mcp_servers` 配置(可多个,每项 name?/url/headers/enable?,enable 默认 true、false 时启动不加载其工具);启动时发现其工具,追加在内置工具之后与 system prompt 一起发给模型;服务不可用仅启动日志告警,工具名重名时加「服务名__」前缀。 +- MCP 服务在 config.yml 的 `mcp_servers` 配置(可多个,每项 name?/url/headers/enable?/timeout_ms?,enable 默认 true、false 时启动不加载其工具;timeout_ms 为该服务单次工具调用最大等待,默认 60s);启动时发现其工具,追加在内置工具之后与 system prompt 一起发给模型;服务不可用仅启动日志告警,工具名重名时加「服务名__」前缀。 部署见 `../docs/DEPLOY.md`。 diff --git a/app/config.example.yml b/app/config.example.yml index a0a8bbc..75d9656 100644 --- a/app/config.example.yml +++ b/app/config.example.yml @@ -129,6 +129,8 @@ model_hold: # MCP 服务(可配多个;与内置工具分开)。启动时对每个服务调 tools/list 发现工具, # 追加到内置工具之后一起发给模型;调用经 tools/call 转发。headers 是任意请求头(如 Authorization)。 # enable 选填、默认 true;设为 false 时启动不加载该服务的工具(配置保留,改回 true 重启即恢复)。 +# timeout_ms 选填、默认 60000:该服务单次工具调用的最大等待(毫秒,有 1s~10min 夹限), +# 像视频生成这类上游就是慢的服务可以调大;握手/工具发现阶段用固定的 15s,不受本项影响。 # 服务不可用时只在启动日志告警,不影响其他服务与内置工具。 # # 无域名部署:agent-core 与 mcp 仓库的容器共用 agent-mcp-net,这里直接写【容器名:容器内端口】, @@ -137,6 +139,7 @@ mcp_servers: - name: web-search # 选填,缺省取主机名首段 url: "http://mcp_web_search:3000/" # web_search 无服务端鉴权,不需要 headers enable: true # 选填,默认 true;false 时启动不加载 + # timeout_ms: 60000 # 选填,单次工具调用最大等待(毫秒),默认 60s # 智谱系服务:token 由客户端透传(每次请求都要带),值填你的智谱 API Key。 # 路径带 /mcp(web_search 是根路径 /,image/video gen 是 /mcp)。 # - name: image-gen diff --git a/app/server/config.js b/app/server/config.js index 3051945..1cb5b9d 100644 --- a/app/server/config.js +++ b/app/server/config.js @@ -4,6 +4,9 @@ const path = require('path'); const YAML = require('yaml'); const log = require('./log'); +// MCP 单次工具调用(tools/call)的缺省最大等待,与 mcp.js 的 CALL_TIMEOUT_MS 保持一致。 +const MCP_CALL_TIMEOUT_MS = 60000; + const DEFAULTS = { port: 8090, // 数据根目录:db、prompt dump 等运行时产物默认放这里(容器内挂 ./data → /workspace/data)。 @@ -40,7 +43,8 @@ const DEFAULTS = { // 登录认证:{ users: [{user, password}], secret?, ttl_ms? },密码明文存配置(自用场景)。 // users 为空则不启用认证(可交给前置 nginx-proxy,但手机浏览器原生下载不带 Basic 头,不推荐)。 auth: null, - // MCP 服务列表:每项 {name?, url, headers?, enable?(默认 true,false 时启动不加载)};启动时发现其工具并追加到内置工具之后。 + // MCP 服务列表:每项 {name?, url, headers?, enable?(默认 true,false 时启动不加载), + // timeout_ms?(单次工具调用最大等待,默认 60s)};启动时发现其工具并追加到内置工具之后。 // 注意与内置工具(definitions.json)严格分离:这里只配外部 MCP 服务。 mcp_servers: [], // 公网临时链接:内置工具 mint_public_link 的唯一开关。base_url 非空时,工具会把会话目录里的 @@ -226,7 +230,8 @@ function parseAndValidate(rawText, configPath) { } // MCP 服务规范化:url 必填;name 缺省取主机名首段;headers 为普通键值对象(如 Authorization); - // enable 缺省 true,显式 false 时启动不加载该服务的工具(见 mcp.init)。 + // enable 缺省 true,显式 false 时启动不加载该服务的工具(见 mcp.init); + // timeout_ms 为该服务单次 tools/call 的最大等待,缺省 60s(长任务服务如视频生成可调大)。 if (!Array.isArray(cfg.mcp_servers)) cfg.mcp_servers = []; for (const s of cfg.mcp_servers) { if (!s || !s.url) throw new Error('mcp_servers 每项必须有 url(MCP 服务的 JSON-RPC 端点)'); @@ -238,6 +243,9 @@ function parseAndValidate(rawText, configPath) { const headers = {}; for (const [k, v] of Object.entries(s.headers || {})) headers[k] = String(v); s.headers = headers; + // 单次工具调用的超时上限:缺省 60s,夹在 [1s, 10min](一次调用长期占着模型槽位,不允许无限等)。 + // YAML 里写成字符串或写了非法值都回落到缺省。 + s.timeout_ms = Math.min(Math.max(Number(s.timeout_ms) || MCP_CALL_TIMEOUT_MS, 1000), 600000); } normalizePublicLink(cfg); diff --git a/app/server/mcp.js b/app/server/mcp.js index 9829fce..411f8d3 100644 --- a/app/server/mcp.js +++ b/app/server/mcp.js @@ -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); } diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index cd32e58..bf73dc8 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -449,6 +449,7 @@ stateDiagram-v2 - 上下文压缩 —— 无配置项:压缩回合的 system prompt 整体替换为固定模板 `server/templates/compress-prompt.txt`,该回合不传 tools;调整压缩策略直接改该文件。 - `auth.users` —— 明文密码配在配置里(自用场景);`secret` 留空则随机生成(重启掉登录态,建议固定随机串)。 - `mcp_servers[].enable: false` —— 启动不加载该服务(配置保留),其余工具不受影响。 +- `mcp_servers[].timeout_ms` —— 该服务单次 `tools/call` 的最大等待,默认 60000(夹在 1s~10min);工具发现/握手用固定 15s,不受本项影响。 - `executor.url` / `executor.token` —— 留空走环境变量 `EXECUTOR_URL` / `EXECUTOR_TOKEN`(compose 默认注入)。 --- @@ -565,7 +566,7 @@ sequenceDiagram ### 11.3 加一个 MCP 服务 -直接改 `config.yml` 的 `mcp_servers` 数组加一项 `{name, url, headers, enable?}`。重启生效。`enable: false` 的服务不加载工具(配置保留),单服务失败只 warn 不影响其他。 +直接改 `config.yml` 的 `mcp_servers` 数组加一项 `{name, url, headers, enable?, timeout_ms?}`。重启生效。`enable: false` 的服务不加载工具(配置保留),单服务失败只 warn 不影响其他。`timeout_ms`(默认 60000,夹在 1s~10min)是该服务单次 `tools/call` 的最大等待。 ### 11.4 加一个模型 / 平台