mcp-multi-bridge 2.1.3 → 2.2.0

package/bin.js

@@ -40,7 +40,16 @@ import { createRequire } from 'node:module';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { loadConfig, findOrg, defaultOrg, allowedPaths, CONFIG_FILE, CONFIG_DIR } from './lib/config.js';
+import {
+    loadConfig,
+    findOrg,
+    defaultOrg,
+    allowedPaths,
+    CONFIG_FILE,
+    CONFIG_DIR,
+    CONFIG_DIR_ERROR,
+    NAME_DIR_SUFFIX
+} from './lib/config.js';
 import { getOrgAuth, getCurrentOrgKey, listLoggedInOrgs } from './lib/token.js';
 import { rpc, extractPayload } from './lib/higress.js';
 import { settings, DEFAULT_SETTINGS } from './lib/settings.js';
@@ -143,11 +152,16 @@ async function handleCli(argv) {
     MCP_BRIDGE_PATHS=/mcp-servers/tc-mes-mcp-server
   然后在 mcp.json 里配多个带不同 env 的条目。
 
-配置文件: ${CONFIG_FILE}
-登录文件: ${CONFIG_DIR}/token.json（由 ${L.loginCommand} 写入）
+配置目录（二选一，必须指定）:
+  MCP_MULTI_HOME=<绝对路径>      旧名 MCP_BRIDGE_HOME 仍兼容
+  --name <系统名>                目录为 ~/.<系统名>${NAME_DIR_SUFFIX}
 
-配置目录可用环境变量 MCP_MULTI_HOME 改到别处（旧名 MCP_BRIDGE_HOME 仍兼容）。
-放在客户端配置的 env 里，可以一个客户端同时接多套系统。默认 ~/.mes-mcp-login。
+  以前没配时会静默用 ~/.mes-mcp-login，导致新系统忘配就读到 MES 的数据。
+  现在没配直接报错，不再猜。
+
+当前配置目录: ${CONFIG_DIR || '（未配置）'}
+配置文件: ${CONFIG_FILE || '（未配置）'}
+登录文件: ${CONFIG_DIR ? CONFIG_DIR + '/token.json' : '（未配置）'}（由 ${L.loginCommand} 写入）
 
 本程序只读上述文件，不会修改或删除。`);
         return true;
@@ -209,6 +223,14 @@ if (await handleCli(process.argv.slice(2))) {
     process.exit(0);
 }
 
+// 走到这里说明要进入 stdio 服务模式。没有配置目录就没法干活，
+// 直接退出并说明原因——绝不像以前那样悄悄回落到某个既有目录，
+// 那会让这个实例读到别的系统的配置与 token。
+if (!CONFIG_DIR) {
+    console.error(`[bridge] ${CONFIG_DIR_ERROR}`);
+    process.exit(1);
+}
+
 function textResult(text, isError = false) {
     return {
         content: [{ type: 'text', text }],
@@ -221,10 +243,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 +280,7 @@ ${L.loginCommand}${homeArg}${orgArg}
 
 执行说明：
 1. 该命令会启动一个临时登录页并在浏览器中打开
-2. 需要在页面上输入用户名密码，并完成图形点选验证码（由人操作，AI 无法代替）
+2. 在页面上完成登录。需要填什么（账号密码、图形验证码等）以页面本身的提示为准，由人操作，AI 无法代替
 3. 登录成功后 token 会自动写入本地文件，本服务**下一次调用即可生效，无需重启**
 4. 命令会一直运行到登录完成才退出，**请以后台方式运行**（run_in_background），避免阻塞
 5. \`--home\` 不能省：本服务读的是 \`${CONFIG_DIR}\`，命令指向别的目录会写错位置
@@ -642,6 +669,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 +683,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/config.js

@@ -5,48 +5,99 @@
  * 配置结构由登录侧 CLI（如 mes-login-cli）定义，两边各自维护默认值必然漂移，
  * 所以桥接层只认文件；文件缺失时明确报错，引导用户去跑登录命令。
  *
- * 目录可换：默认沿用 ~/.mes-mcp-login（历史约定），
- * 用 MCP_BRIDGE_HOME 指向别的目录即可支持第二套系统并存，
- * 两套互不干扰，各自登录各自的 token。
+ * 配置目录必须显式指定，两种方式：
+ *   1. MCP_MULTI_HOME=<绝对路径>   直接指目录
+ *   2. --name <系统名>             用约定目录 ~/.<系统名>-mcp-login
+ *
+ * 故意不设「默认目录」。以前没配时会静默回落到 ~/.mes-mcp-login，
+ * 结果是新加的系统忘了配就默默读到 MES 的配置和 token，
+ * 工具名显示 erp、数据却是 MES 的，且不报错——跨系统串数据极难排查。
+ * 现在没配就报错，宁可启动失败也不要读错数据。
  */
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 
-/** 历史默认目录，保持兼容 */
-const LEGACY_DIR_NAME = '.mes-mcp-login';
+/** 用 --name 推导目录时统一加的后缀 */
+export const NAME_DIR_SUFFIX = '-mcp-login';
+
+/**
+ * 从命令行取 --name 的值
+ *
+ * 支持 `--name erp` / `--name=erp` / `-n erp`。
+ * 放在 config.js 里读 process.argv 是因为 CONFIG_DIR 是模块级常量，
+ * 在 import 阶段就要算出来——此时 argv 已就绪，可用。
+ */
+function nameFromArgv() {
+    const argv = process.argv.slice(2);
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--name' || a === '-n') return String(argv[i + 1] || '').trim();
+        if (a.startsWith('--name=')) return a.slice('--name='.length).trim();
+    }
+    return '';
+}
+
+/** 展开 ~ 与相对路径 */
+function expand(raw) {
+    const s = String(raw || '').trim();
+    if (!s) return '';
+    if (s === '~') return os.homedir();
+    if (s.startsWith('~/') || s.startsWith('~\\')) return path.join(os.homedir(), s.slice(2));
+    return path.resolve(s);
+}
 
 /**
  * 解析配置目录
  *
- * 优先级：MCP_MULTI_HOME > MCP_BRIDGE_HOME（旧名） > ~/.mes-mcp-login
+ * 优先级：MCP_MULTI_HOME > MCP_BRIDGE_HOME（旧名） > --name 推导
  * 用环境变量而不是 config.json 里的字段——要读配置就得先知道目录，写进配置里是循环依赖。
  *
- * 与登录 CLI 用同一套变量名，两边必须读到同一个目录，否则登录完 bridge 找不到 token。
+ * @returns {{dir:string, error:string|null}} dir 为空表示未配置
  */
 function resolveDir() {
     const pick = (v) => (typeof v === 'string' && v.trim() ? v.trim() : '');
+
     const custom = pick(process.env.MCP_MULTI_HOME) || pick(process.env.MCP_BRIDGE_HOME);
-    if (custom) {
-        // 支持 ~ 开头，避免用户写了相对路径找不到
-        if (custom === '~') return os.homedir();
-        if (custom.startsWith('~/') || custom.startsWith('~\\')) {
-            return path.join(os.homedir(), custom.slice(2));
+    if (custom) return { dir: expand(custom), error: null };
+
+    const name = pick(nameFromArgv());
+    if (name) {
+        // --name 会拼进路径，限定字符集，避免 ../ 之类跑出 home 目录
+        if (!/^[A-Za-z0-9._-]+$/.test(name) || name === '.' || name === '..') {
+            return {
+                dir: '',
+                error: `--name 的值不合法：「${name}」。只允许字母、数字、点、下划线、连字符。`
+            };
         }
-        return path.resolve(custom);
+        return { dir: path.join(os.homedir(), `.${name}${NAME_DIR_SUFFIX}`), error: null };
     }
-    return path.join(os.homedir(), LEGACY_DIR_NAME);
+
+    return {
+        dir: '',
+        error:
+            '未指定配置目录。启动时加其中之一：\n' +
+            '  1) 环境变量 MCP_MULTI_HOME=<配置目录绝对路径>\n' +
+            `  2) 命令行参数 --name <系统名>（目录为 ~/.<系统名>${NAME_DIR_SUFFIX}）\n` +
+            'MCP 客户端里一般写在 mcp.json 的 env 或 args。'
+    };
 }
 
-export const CONFIG_DIR = resolveDir();
-export const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
-export const TOKEN_FILE = path.join(CONFIG_DIR, 'token.json');
+const RESOLVED = resolveDir();
+
+/** 配置目录；未配置时为空字符串 */
+export const CONFIG_DIR = RESOLVED.dir;
+/** 未配置时的说明文字；已配置为 null */
+export const CONFIG_DIR_ERROR = RESOLVED.error;
+export const CONFIG_FILE = CONFIG_DIR ? path.join(CONFIG_DIR, 'config.json') : '';
+export const TOKEN_FILE = CONFIG_DIR ? path.join(CONFIG_DIR, 'token.json') : '';
 
 /**
  * 读取配置
- * @returns {object|null} 配置对象；文件缺失或损坏返回 null
+ * @returns {object|null} 配置对象；未配置目录、文件缺失或损坏都返回 null
  */
 export function loadConfig() {
+    if (!CONFIG_FILE) return null;
     try {
         if (!fs.existsSync(CONFIG_FILE)) return null;
         const cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));

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.2.0",
   "description": "多后端 MCP 桥接：把网关后多个后端、多个租户的工具集合并成一个 MCP 服务，凭据由登录 CLI 提供",
   "type": "module",
   "bin": {