mcp-multi-bridge 2.3.1 → 2.3.2

package/README.md

@@ -300,6 +300,54 @@ bridge 侧**不维护任何业务词对照表**。
 两种做法的取舍：拆 server 简单但要维护多套配置和凭证；分层只维护一套，
 代价是每次找工具多一跳。系统数量不多时，拆 server 更省事。
 
+### 网关侧认证（key-auth）
+
+桥接默认只发 `Content-Type`，不带任何认证头——业务登录 token 是作为**工具参数**
+传给后端的，不参与网关认证。所以当网关对某个端点开了 Key 认证时，
+必须让桥接额外带一个头，否则该端点会直接 401（表现为只剩本地的 `login` 工具）。
+
+三个来源，后者覆盖前者：
+
+| 来源 | 作用范围 | 适合 |
+| --- | --- | --- |
+| `MCP_BRIDGE_HEADERS`（环境变量，JSON） | 本实例所有组织 | 一套凭证走全部环境 |
+| `config.json` 顶层 `headers` | 本实例所有组织 | 同上，但想写进配置文件 |
+| `orgs[].headers` | 单个组织 | 每个环境用不同凭证 |
+
+最省事的是写在客户端条目的 `env` 里：
+
+```json
+{
+  "mcpServers": {
+    "mes": {
+      "command": "mcp-multi-bridge",
+      "args": ["--name", "mes"],
+      "env": {
+        "MCP_BRIDGE_HEADERS": "{\"Authorization\":\"Bearer <网关消费者凭证>\"}"
+      }
+    }
+  }
+}
+```
+
+要给不同环境配不同消费者，就写进 `config.json` 的组织里（优先级更高）：
+
+```json
+{
+  "orgs": [
+    { "key": "test", "path": "/mcp-servers/mes-mcp-server" },
+    { "key": "prod", "path": "/mcp-servers/tc-mes-mcp-server",
+      "headers": { "Authorization": "Bearer <prod 的凭证>" } }
+  ]
+}
+```
+
+三个来源都没配时，请求头与旧版完全一致，不影响未开认证的网关。
+
+> 凭证是明文，别提交进仓库；`MCP_BRIDGE_HEADERS` 不是合法 JSON 时会被忽略并打一行提示，
+> 不会让进程退出——但那个端点会因此 401，排查时先看这条提示。
+
+
 ## 检查安装的版本
 
 ```bash

package/lib/higress.js

@@ -12,13 +12,44 @@ import { orgUrl } from './config.js';
 // 自增 id，避免同毫秒并发撞号
 let rpcSeq = 0;
 
+/**
+ * 附加到网关请求上的头
+ *
+ * 用于网关侧的消费者认证（如 key-auth 的 Authorization）。三个来源按优先级合并，
+ * 后者覆盖前者：
+ *   1. 环境变量 MCP_BRIDGE_HEADERS —— 客户端 mcp.json 的 env 里配，JSON 字符串
+ *   2. config.json 顶层 headers —— 对本实例所有组织生效
+ *   3. orgs[].headers —— 只对该组织生效，用于不同环境不同凭证
+ *
+ * 都没配时返回空对象，请求头与旧版完全一致（不改变既有行为）。
+ * 为什么不放在工具参数里：网关的 key-auth 只认请求头，参数是给后端业务用的。
+ */
+export function bridgeHeaders(cfg, org) {
+    let fromEnv = {};
+    const raw = process.env.MCP_BRIDGE_HEADERS;
+    if (raw) {
+        try {
+            const v = JSON.parse(raw);
+            if (v && typeof v === 'object' && !Array.isArray(v)) fromEnv = v;
+            else console.error('[bridge] MCP_BRIDGE_HEADERS 必须是 JSON 对象，已忽略');
+        } catch (e) {
+            console.error('[bridge] MCP_BRIDGE_HEADERS 不是合法 JSON，已忽略');
+        }
+    }
+    return {
+        ...fromEnv,
+        ...((cfg && cfg.headers) || {}),
+        ...((org && org.headers) || {})
+    };
+}
+
 /**
  * 发一个 JSON-RPC 请求到网关
  */
 export async function rpc(cfg, org, method, params) {
     const res = await fetch(orgUrl(cfg, org), {
         method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
+        headers: { 'Content-Type': 'application/json', ...bridgeHeaders(cfg, org) },
         body: JSON.stringify({ jsonrpc: '2.0', id: ++rpcSeq, method, params })
     });
     const text = await res.text();

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "mcp-multi-bridge",
-  "version": "2.3.1",
-  "description": "多后端 MCP 桥接：把网关后多个后端、多个租户的工具集合并成一个 MCP 服务，凭据由登录 CLI 提供",
-  "type": "module",
-  "bin": {
-    "mcp-multi-bridge": "bin.js"
-  },
-  "files": [
-    "bin.js",
-    "lib/",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "start": "node bin.js",
-    "pack:check": "npm pack --dry-run",
-    "test": "node test/toolindex.test.mjs"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "bridge",
-    "multi-tenant",
-    "multi-backend",
-    "mes"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.20.2"
-  }
-}
+{
+  "name": "mcp-multi-bridge",
+  "version": "2.3.2",
+  "description": "多后端 MCP 桥接：把网关后多个后端、多个租户的工具集合并成一个 MCP 服务，凭据由登录 CLI 提供",
+  "type": "module",
+  "bin": {
+    "mcp-multi-bridge": "bin.js"
+  },
+  "files": [
+    "bin.js",
+    "lib/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node bin.js",
+    "pack:check": "npm pack --dry-run",
+    "test": "node test/toolindex.test.mjs && node test/headers.test.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "bridge",
+    "multi-tenant",
+    "multi-backend",
+    "mes"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.2"
+  }
+}