mcp-multi-bridge 2.1.3 → 2.1.4

package/bin.js

@@ -221,10 +221,15 @@ function textResult(text, isError = false) {
  *
  * 这段文字是给模型看的指令：告诉它当前登录态不可用，以及该执行什么命令。
  * 之所以写这么具体，是因为模型拿不到本文件的上下文，
- * 只说「请登录」它不知道登录入口在哪、也不知道要等待人机验证。
+ * 只说「请登录」它不知道登录入口在哪、也不知道要等待人机操作。
+ *
+ * 注意：这里**不描述登录页上有什么**。验证码、密码策略、二次验证之类的差异
+ * 属于登录包和页面的事（由 protocol.adapter 与页面自己决定），而且页面本身
+ * 就有提示。桥接层写死「需要图形验证码」会让无验证码的系统（如 EBS-Plus）
+ * 收到错误指令，模型据此让人去点一个根本不存在的验证码。
  *
  * 命令里必须带 --home：同一个客户端可能同时接多套系统，各自一个配置目录。
- * 只说 `mes-login` 会让模型登到另一套系统去，那边看起来成功了、
+ * 只说 `mcp-multi-login` 会让模型登到另一套系统去，那边看起来成功了、
  * 这边的 token 却没变，表现是「登录了但还是未登录」，非常难查。
  *
  * @param {string} status 状态描述，如「未登录」/「登录已失效（code=613：token 已过期）」
@@ -253,7 +258,7 @@ ${L.loginCommand}${homeArg}${orgArg}
 
 执行说明：
 1. 该命令会启动一个临时登录页并在浏览器中打开
-2. 需要在页面上输入用户名密码，并完成图形点选验证码（由人操作，AI 无法代替）
+2. 在页面上完成登录。需要填什么（账号密码、图形验证码等）以页面本身的提示为准，由人操作，AI 无法代替
 3. 登录成功后 token 会自动写入本地文件，本服务**下一次调用即可生效，无需重启**
 4. 命令会一直运行到登录完成才退出，**请以后台方式运行**（run_in_background），避免阻塞
 5. \`--home\` 不能省：本服务读的是 \`${CONFIG_DIR}\`，命令指向别的目录会写错位置
@@ -642,6 +647,12 @@ async function main() {
             });
 
             const payload = extractPayload(result);
+
+            // 失效判定有两个维度：
+            //   invalidCodes      业务码，绝大多数系统走这条（HTTP 200 + code）
+            //   invalidHttpStatus 响应体里的 status 字段，给那些把认证失败兜成 HTTP 错误的系统用
+            // 两者字段不重叠：业务响应用 code，框架默认错误页用 status，
+            // 所以简单的 or 关系不会互相误伤。
             if (payload && S.invalidCodes.includes(payload.code)) {
                 const why = S.invalidReasons[payload.code] || payload.message || '凭据不可用';
                 console.error(`[bridge] ${S.tenantLabel} ${org.key} 的凭据不可用（code=${payload.code}）`);
@@ -650,6 +661,20 @@ async function main() {
                     true
                 );
             }
+            if (payload && S.invalidHttpStatus.includes(payload.status)) {
+                const why = S.invalidReasons[payload.status] || 'HTTP ' + payload.status;
+                console.error(
+                    `[bridge] ${S.tenantLabel} ${org.key} 的凭据不可用（HTTP ${payload.status}）`
+                );
+                return textResult(
+                    loginGuide(
+                        `${S.systemName}${S.nameGap}登录已失效（HTTP ${payload.status}：${why}）`,
+                        org,
+                        cfg
+                    ),
+                    true
+                );
+            }
 
             // 正常结果：附一条组织说明，让模型知道这份数据属于哪个组织
             const L = S;

package/lib/settings.js

@@ -9,6 +9,7 @@
  *   credentialField   注入到工具参数里的凭据字段名               默认 access_token
  *   hiddenArgs        对模型隐藏的参数（凭据与租户 ID 由本层填） 默认 access_token / orgId
  *   invalidCodes      表示登录态失效的业务错误码                 默认 613/614/615/616
+ *   invalidHttpStatus 表示登录态失效的 HTTP 状态码               默认空（不启用）
  *   loginCommand      登录引导里让模型执行的命令                 默认 mcp-multi-login
  *
  * 全部有默认值，不配置时行为与改造前完全一致。
@@ -27,6 +28,16 @@ export const DEFAULT_TENANT_ID_FIELD = 'orgId';
 export const DEFAULT_HIDDEN_ARGS = [DEFAULT_CREDENTIAL_FIELD, DEFAULT_TENANT_ID_FIELD];
 /** 默认的登录失效错误码 */
 export const DEFAULT_INVALID_CODES = [613, 614, 615, 616];
+/**
+ * 默认的登录失效 HTTP 状态码
+ *
+ * 默认空数组——大多数系统（如 MES）认证失败也返回 HTTP 200 + 业务码，
+ * 靠 invalidCodes 判定就够了。默认开某个状态码会误伤正常的业务异常。
+ *
+ * 只有明确知道「某状态码在此系统上等价于认证失败」时才配。
+ * 典型场景：EBS-Plus 的网关把认证失败兜成了 500，拿不到业务码。
+ */
+export const DEFAULT_INVALID_HTTP_STATUS = [];
 /**
  * 默认登录命令
  *
@@ -92,7 +103,7 @@ function reasonMap(v) {
  * @returns {{
  *   systemName:string, tenantLabel:string, nameGap:string,
  *   credentialField:string, hiddenArgs:string[],
- *   invalidCodes:number[], invalidReasons:Record<number,string>,
+ *   invalidCodes:number[], invalidHttpStatus:number[], invalidReasons:Record<number,string>,
  *   loginCommand:string
  * }}
  */
@@ -119,6 +130,7 @@ export function settings(cfg) {
         tenantIdField,
         hiddenArgs,
         invalidCodes: codeList(cfg?.invalidCodes, DEFAULT_INVALID_CODES),
+        invalidHttpStatus: codeList(cfg?.invalidHttpStatus, DEFAULT_INVALID_HTTP_STATUS),
         invalidReasons: reasonMap(cfg?.invalidCodeReasons),
         loginCommand: isNonEmptyString(cfg?.loginCommand) ? cfg.loginCommand.trim() : DEFAULT_LOGIN_COMMAND
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-multi-bridge",
-  "version": "2.1.3",
+  "version": "2.1.4",
   "description": "多后端 MCP 桥接：把网关后多个后端、多个租户的工具集合并成一个 MCP 服务，凭据由登录 CLI 提供",
   "type": "module",
   "bin": {