diff --git a/app/README.md b/app/README.md index b4e1b22..a1ec38c 100644 --- a/app/README.md +++ b/app/README.md @@ -56,6 +56,6 @@ System prompt 完全静态(所有会话共用,利于上游前缀缓存), - 规划阶段点「开始执行」:追加固定模板消息并切 execution。 - 终止:置位标志 + kill 进程组 + 中止模型流,不再发新请求。 - 所有文件路径解析到任务目录内,拒绝越界。 -- MCP 服务在 config.yml 的 `mcp_servers` 配置(可多个,每项 name?/url/headers);启动时发现其工具,追加在内置工具之后与 system prompt 一起发给模型;服务不可用仅启动日志告警,工具名重名时加「服务名__」前缀。 +- MCP 服务在 config.yml 的 `mcp_servers` 配置(可多个,每项 name?/url/headers/enable?,enable 默认 true、false 时启动不加载其工具);启动时发现其工具,追加在内置工具之后与 system prompt 一起发给模型;服务不可用仅启动日志告警,工具名重名时加「服务名__」前缀。 部署见 `../docs/DEPLOY.md`。 diff --git a/app/config.example.yml b/app/config.example.yml index d86fc40..69333dd 100644 --- a/app/config.example.yml +++ b/app/config.example.yml @@ -107,9 +107,11 @@ compress: # MCP 服务(可配多个;与内置工具分开)。启动时对每个服务调 tools/list 发现工具, # 追加到内置工具之后一起发给模型;调用经 tools/call 转发。headers 是任意请求头(如 Authorization)。 +# enable 选填、默认 true;设为 false 时启动不加载该服务的工具(配置保留,改回 true 重启即恢复)。 # 服务不可用时只在启动日志告警,不影响其他服务与内置工具。 mcp_servers: - name: web-search # 选填,缺省取主机名首段 url: "https://web-search.ai.foresh.com/" + enable: true # 选填,默认 true;false 时启动不加载 headers: Authorization: "Basic a2ljZXI6USF3MmUzcjQ=" diff --git a/app/server/config.js b/app/server/config.js index e74ed9b..f4f6405 100644 --- a/app/server/config.js +++ b/app/server/config.js @@ -37,7 +37,7 @@ const DEFAULTS = { // 登录认证:{ users: [{user, password}], secret?, ttl_ms? },密码明文存配置(自用场景)。 // users 为空则不启用认证(可交给前置 nginx-proxy,但手机浏览器原生下载不带 Basic 头,不推荐)。 auth: null, - // MCP 服务列表:每项 {name?, url, headers?};启动时发现其工具并追加到内置工具之后。 + // MCP 服务列表:每项 {name?, url, headers?, enable?(默认 true,false 时启动不加载)};启动时发现其工具并追加到内置工具之后。 // 注意与内置工具(definitions.json)严格分离:这里只配外部 MCP 服务。 mcp_servers: [], }; @@ -195,13 +195,16 @@ function parseAndValidate(rawText, configPath) { log.info('config', '检测到旧配置 web_search.*,已自动转为一条 mcp_servers;建议更新 config.yml 为 mcp_servers 格式'); } - // MCP 服务规范化:url 必填;name 缺省取主机名首段;headers 为普通键值对象(如 Authorization) + // MCP 服务规范化:url 必填;name 缺省取主机名首段;headers 为普通键值对象(如 Authorization); + // enable 缺省 true,显式 false 时启动不加载该服务的工具(见 mcp.init)。 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 端点)'); if (!s.name) { try { s.name = String(new URL(s.url).hostname.split('.')[0]); } catch (_) { s.name = 'mcp'; } } + // 容错 YAML 里写成字符串 "false" / "off" 的情况,统一归一为布尔 + s.enable = !(s.enable === false || s.enable === 'false' || s.enable === 'off' || s.enable === 0); const headers = {}; for (const [k, v] of Object.entries(s.headers || {})) headers[k] = String(v); s.headers = headers; diff --git a/app/server/mcp.js b/app/server/mcp.js index 6991ac8..9829fce 100644 --- a/app/server/mcp.js +++ b/app/server/mcp.js @@ -1,6 +1,6 @@ // 极简 MCP 客户端(Streamable HTTP:JSON-RPC over HTTP,无状态,响应可能是 SSE 帧包裹的 JSON)。 -// MCP 服务在 config.yml 的 mcp_servers 中配置(可多个):{name?, url, headers?}。 -// 启动时 init() 对每个服务调 tools/list 发现工具,转成 OpenAI function 格式, +// MCP 服务在 config.yml 的 mcp_servers 中配置(可多个):{name?, url, headers?, enable?}。 +// 启动时 init() 对每个服务调 tools/list 发现工具(enable: false 的服务跳过加载),转成 OpenAI function 格式, // 追加在内置工具(definitions.json)之后一起随 system prompt 发给模型; // 工具调用经 tools/call 转发给对应服务。 // 与内置工具严格分离:本模块不碰内置定义;MCP 工具默认沿用原始名, @@ -97,6 +97,11 @@ async function init(cfg) { const servers = (cfg && cfg.mcp_servers) || []; for (const s of servers) { + // enable: false 时启动不加载该服务(不建工具表;配置保留,改回 true 重启后恢复) + if (s.enable === false) { + log.info('mcp', s.name + ': enable=false,跳过工具加载'); + continue; + } // 清理上次会话 id(重启后服务端会拒绝旧 id;不清理会一直 400) s.sessionId = null; try { diff --git a/app/server/public/index.html b/app/server/public/index.html index 1f000ef..0c21a4e 100644 --- a/app/server/public/index.html +++ b/app/server/public/index.html @@ -1047,7 +1047,8 @@ list.innerHTML = '