mcp-multi-bridge 2.0.0 → 2.1.0

package/README.md

@@ -13,12 +13,12 @@
 ## 安装
 
 ```bash
-npm i -g mcp-multi-bridge mes-login-cli
+npm i -g mcp-multi-bridge mcp-multi-login
 ```
 
 两个包配合使用：
 
-- `mes-login-cli` 负责登录，把 token 写入本地文件
+- `mcp-multi-login` 负责登录，把 token 写入本地文件（旧名 `mes-login-cli`，命令 `mes-login` 仍可用）
 - `mcp-multi-bridge` 负责读取 token 并转发请求
 
 > **从 `mes-mcp-bridge` 升级是破坏性的，按下面三步走**
@@ -249,29 +249,59 @@ npm root -g
 不会让服务起不来。`systemName` 以汉字结尾时不加空格（「查询 ERP 中台的租户」），
 以拉丁字母结尾时加（「查询 MES 的组织」）。
 
-## 配置目录
+## 配置目录与多系统并存
 
-**有默认目录：`~/.mes-mcp-login`**，不设环境变量就用它。
+**默认目录 `~/.mes-mcp-login`**，不设环境变量就用它。现有用户升级后行为不变。
 
-目录名仍带 `mes` 是**故意不改**的——`mes-login-cli` 把 `config.json` 和 `token.json`
-写在这个路径下（写死，不支持环境变量）。桥接层的默认值必须与它一致，否则登录完
-照样找不到文件。要改名得两个包一起改。
+目录名带 `mes` 是历史沿革：`mcp-multi-login` 的默认值也是它，两边必须一致，
+否则登录完桥接层找不到 token。要改名得两个包一起改。
 
-所以 `MCP_BRIDGE_HOME` 的用途是**跑第二套系统时隔离**，不是改默认位置：
+**同一个客户端接多套系统**时，每个 bridge 实例指向不同目录：
 
-```bash
-# 第二套系统（非 MES）单独一份配置与登录态
-export MCP_BRIDGE_HOME=~/.erp-bridge
+```json
+{
+  "mcpServers": {
+    "mes": {
+      "command": "mcp-multi-bridge",
+      "args": [],
+      "env": { "MCP_MULTI_HOME": "C:/Users/你/.mes-mcp-login" }
+    },
+    "erp": {
+      "command": "mcp-multi-bridge",
+      "args": [],
+      "env": { "MCP_MULTI_HOME": "C:/Users/你/.erp-login" }
+    }
+  }
+}
 ```
 
-目录里同样放 `config.json` 和 `token.json`，两套互不干扰，各自登录各自的 token。
+工具名由客户端加前缀区分（`mcp__mes__captchaGet` / `mcp__erp__captchaGet`），同名工具不冲突。
 
 | 环境变量 | 作用 | 默认 |
 |---|---|---|
-| `MCP_BRIDGE_HOME` | 配置目录 | `~/.mes-mcp-login` |
+| `MCP_MULTI_HOME` | 配置目录 | `~/.mes-mcp-login` |
+| `MCP_BRIDGE_HOME` | 同上（旧名，仍兼容） | — |
 | `MCP_BRIDGE_PATHS` | 限定本实例负责的 path，逗号分隔 | 不限制（全部加载） |
 
-> 旧名 `MES_MCP_PATHS` 仍兼容，`MCP_BRIDGE_PATHS` 优先。
+> `MCP_MULTI_HOME` 优先于 `MCP_BRIDGE_HOME`；`MCP_BRIDGE_PATHS` 优先于旧名 `MES_MCP_PATHS`。
+
+### 登录引导会带上 `--home`
+
+未登录或登录失效时，本服务返回的引导命令是**完整可执行**的：
+
+```bash
+mcp-multi-login --home "C:/Users/你/.mes-mcp-login" --org tc
+```
+
+`--home` 指向本实例实际读取的目录，不能省——省了就会写到默认目录去，
+表现是「登录成功了但这边还是未登录」，非常难查。
+
+若登录命令不是默认的 `mcp-multi-login`（例如仍在用旧的 `mes-login`），
+用 `loginCommand` 配置改：
+
+```json
+{ "loginCommand": "mes-login" }
+```
 
 ## 文件依赖
 
@@ -279,12 +309,12 @@ export MCP_BRIDGE_HOME=~/.erp-bridge
 
 | 文件 | 由谁创建 |
 |---|---|
-| `config.json` | 登录侧 CLI（如 `mes-login-cli`），也可手写 |
+| `config.json` | 登录侧 CLI（`mcp-multi-login` / 旧 `mes-login-cli`），也可手写 |
 | `token.json` | 登录侧 CLI（登录时写入） |
 
 本包**只读不写**，不会创建、修改或删除这两个文件。
 
-所以使用前必须先安装并运行一次登录 CLI（MES 用 `mes-login-cli`）。
+所以使用前必须先安装并运行一次登录 CLI（`mcp-multi-login`）。
 
 ## 提供的工具
 

package/bin.js

@@ -146,7 +146,8 @@ async function handleCli(argv) {
 配置文件: ${CONFIG_FILE}
 登录文件: ${CONFIG_DIR}/token.json（由 ${L.loginCommand} 写入）
 
-配置目录可用环境变量 MCP_BRIDGE_HOME 改到别处（默认 ~/.mes-mcp-login）。
+配置目录可用环境变量 MCP_MULTI_HOME 改到别处（旧名 MCP_BRIDGE_HOME 仍兼容）。
+放在客户端配置的 env 里，可以一个客户端同时接多套系统。默认 ~/.mes-mcp-login。
 
 本程序只读上述文件，不会修改或删除。`);
         return true;
@@ -222,15 +223,24 @@ function textResult(text, isError = false) {
  * 之所以写这么具体，是因为模型拿不到本文件的上下文，
  * 只说「请登录」它不知道登录入口在哪、也不知道要等待人机验证。
  *
+ * 命令里必须带 --home：同一个客户端可能同时接多套系统，各自一个配置目录。
+ * 只说 `mes-login` 会让模型登到另一套系统去，那边看起来成功了、
+ * 这边的 token 却没变，表现是「登录了但还是未登录」，非常难查。
+ *
  * @param {string} status 状态描述，如「未登录」/「登录已失效（code=613：token 已过期）」
- * @param {{key:string, name:string}} [org] 相关组织，用于预设登录页选中的组织
+ * @param {{key:string, name:string}} [org] 相关租户，用于预设登录页选中的租户
  * @param {object|null} [cfg] 配置，用于取系统名与租户称谓；不传则用默认值
  */
 function loginGuide(status, org, cfg) {
     const L = cfg ? settings(cfg) : DEFAULT_SETTINGS;
+    // --home 用本实例实际读的目录，保证与登录写入的是同一个。
+    // 反斜杠统一转正斜杠：Windows 下 CMD / PowerShell / Git Bash 都能正确解析，
+    // 反斜杠在部分 shell 里会被当转义字符。
+    const homeForCmd = String(CONFIG_DIR).replace(/\\/g, '/');
+    const homeArg = ` --home "${homeForCmd}"`;
     const orgArg = org && org.key ? ` --org ${org.key}` : '';
     const orgLine = org
-        ? `\n相关${L.tenantLabel}：${org.name}（已通过 --org ${orgArg.trim()} 预设选中）\n`
+        ? `\n相关${L.tenantLabel}：${org.name}（已通过 --org ${org.key} 预设选中）\n`
         : '';
 
     return `## ${status}
@@ -238,7 +248,7 @@ function loginGuide(status, org, cfg) {
 请调用 Bash 工具执行以下命令，启动 ${L.systemName}${L.nameGap}登录页：
 
 \`\`\`bash
-${L.loginCommand}${orgArg}
+${L.loginCommand}${homeArg}${orgArg}
 \`\`\`
 
 执行说明：
@@ -246,6 +256,7 @@ ${L.loginCommand}${orgArg}
 2. 需要在页面上输入用户名密码，并完成图形点选验证码（由人操作，AI 无法代替）
 3. 登录成功后 token 会自动写入本地文件，本服务**下一次调用即可生效，无需重启**
 4. 命令会一直运行到登录完成才退出，**请以后台方式运行**（run_in_background），避免阻塞
+5. \`--home\` 不能省：本服务读的是 \`${CONFIG_DIR}\`，命令指向别的目录会写错位置
 ${orgLine}
 登录完成后，请重新调用刚才的工具。
 `;

package/lib/config.js

@@ -19,19 +19,21 @@ const LEGACY_DIR_NAME = '.mes-mcp-login';
 /**
  * 解析配置目录
  *
- * 优先级：MCP_BRIDGE_HOME > ~/.mes-mcp-login
+ * 优先级：MCP_MULTI_HOME > MCP_BRIDGE_HOME（旧名） > ~/.mes-mcp-login
  * 用环境变量而不是 config.json 里的字段——要读配置就得先知道目录，写进配置里是循环依赖。
+ *
+ * 与登录 CLI 用同一套变量名，两边必须读到同一个目录，否则登录完 bridge 找不到 token。
  */
 function resolveDir() {
-    const custom = process.env.MCP_BRIDGE_HOME;
-    if (typeof custom === 'string' && custom.trim()) {
+    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) {
         // 支持 ~ 开头，避免用户写了相对路径找不到
-        const raw = custom.trim();
-        if (raw === '~') return os.homedir();
-        if (raw.startsWith('~/') || raw.startsWith('~\\')) {
-            return path.join(os.homedir(), raw.slice(2));
+        if (custom === '~') return os.homedir();
+        if (custom.startsWith('~/') || custom.startsWith('~\\')) {
+            return path.join(os.homedir(), custom.slice(2));
         }
-        return path.resolve(raw);
+        return path.resolve(custom);
     }
     return path.join(os.homedir(), LEGACY_DIR_NAME);
 }

package/package.json

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