mcp-multi-bridge 0.0.0-stage → 2.1.0

package/lib/config.js

@@ -0,0 +1,93 @@
+/**
+ * config.js —— 只读配置
+ *
+ * 本模块不创建、不写入 config.json，也不内置默认值。
+ * 配置结构由登录侧 CLI（如 mes-login-cli）定义，两边各自维护默认值必然漂移，
+ * 所以桥接层只认文件；文件缺失时明确报错，引导用户去跑登录命令。
+ *
+ * 目录可换：默认沿用 ~/.mes-mcp-login（历史约定），
+ * 用 MCP_BRIDGE_HOME 指向别的目录即可支持第二套系统并存，
+ * 两套互不干扰，各自登录各自的 token。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+/** 历史默认目录，保持兼容 */
+const LEGACY_DIR_NAME = '.mes-mcp-login';
+
+/**
+ * 解析配置目录
+ *
+ * 优先级：MCP_MULTI_HOME > MCP_BRIDGE_HOME（旧名） > ~/.mes-mcp-login
+ * 用环境变量而不是 config.json 里的字段——要读配置就得先知道目录，写进配置里是循环依赖。
+ *
+ * 与登录 CLI 用同一套变量名，两边必须读到同一个目录，否则登录完 bridge 找不到 token。
+ */
+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));
+        }
+        return path.resolve(custom);
+    }
+    return path.join(os.homedir(), LEGACY_DIR_NAME);
+}
+
+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');
+
+/**
+ * 读取配置
+ * @returns {object|null} 配置对象；文件缺失或损坏返回 null
+ */
+export function loadConfig() {
+    try {
+        if (!fs.existsSync(CONFIG_FILE)) return null;
+        const cfg = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+        if (!cfg || !Array.isArray(cfg.orgs) || !cfg.orgs.length) return null;
+        cfg.baseUrl = String(cfg.baseUrl || '').replace(/\/+$/, '');
+        return cfg;
+    } catch (e) {
+        return null;
+    }
+}
+
+export function findOrg(cfg, key) {
+    if (!cfg) return null;
+    return cfg.orgs.find((o) => o.key === key) || null;
+}
+
+export function defaultOrg(cfg) {
+    if (!cfg) return null;
+    return cfg.orgs.find((o) => o.default) || cfg.orgs[0] || null;
+}
+
+// 拼出某个组织的完整 MCP 地址
+export function orgUrl(cfg, org) {
+    const p = String(org.path || '').startsWith('/') ? org.path : '/' + org.path;
+    return cfg.baseUrl + p;
+}
+
+/**
+ * 限定本实例负责的 path（多 server 拆分用）
+ *
+ * 环境变量优先级：MCP_BRIDGE_PATHS > MES_MCP_PATHS（旧名，保留兼容）
+ * 这里只做切分；容错匹配（允许只写末段）由调用方的 pathAllowed 处理。
+ *
+ * @returns {string[]|null} null 表示不限制
+ */
+export function allowedPaths() {
+    const pick = (v) => (typeof v === 'string' && v.trim() ? v.trim() : '');
+    const raw = pick(process.env.MCP_BRIDGE_PATHS) || pick(process.env.MES_MCP_PATHS);
+    if (!raw) return null;
+    return raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}

package/lib/higress.js

@@ -0,0 +1,49 @@
+/**
+ * higress.js —— 转发到网关的 MCP 端点
+ *
+ * 只做两件事：把 tools/list 直接转发；把 tools/call 补上凭据后转发。
+ * 网关侧的路由凭据（appId / appKey / 租户 ID 等）由网关在转发时注入，本进程不持有。
+ *
+ * 这里不判断「哪个错误码代表登录失效」——那是业务系统的知识，
+ * 由 settings.js 从配置里读（invalidCodes / invalidCodeReasons）。
+ */
+import { orgUrl } from './config.js';
+
+// 自增 id，避免同毫秒并发撞号
+let rpcSeq = 0;
+
+/**
+ * 发一个 JSON-RPC 请求到网关
+ */
+export async function rpc(cfg, org, method, params) {
+    const res = await fetch(orgUrl(cfg, org), {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ jsonrpc: '2.0', id: ++rpcSeq, method, params })
+    });
+    const text = await res.text();
+    try {
+        return JSON.parse(text);
+    } catch (e) {
+        throw new Error(`网关响应异常（HTTP ${res.status}）: ${text.slice(0, 120)}`);
+    }
+}
+
+/**
+ * 从 MCP 工具返回里取出业务 JSON
+ * 网关可能在正文前拼一段说明文字，需从第一个 { 截取
+ */
+export function extractPayload(rpcResult) {
+    const content = rpcResult?.result?.content;
+    if (!Array.isArray(content) || !content.length) {
+        return rpcResult?.result?.isError ? { code: -1, message: '调用失败' } : null;
+    }
+    const text = content[0].text || '';
+    const start = text.indexOf('{');
+    if (start === -1) return { code: -1, message: text.trim() || '响应无 JSON 内容' };
+    try {
+        return JSON.parse(text.slice(start));
+    } catch (e) {
+        return { code: -1, message: text.slice(0, 200) };
+    }
+}

package/lib/settings.js

@@ -0,0 +1,125 @@
+/**
+ * settings.js —— 可配置的系统差异点
+ *
+ * 这套桥接的核心逻辑（按 path 去重合并、租户隔离、凭据注入、状态查询工具）
+ * 与具体业务系统无关。真正随系统变化的是五件事，全部收在这里：
+ *
+ *   systemName        系统名，出现在标题与描述里                 默认 MES
+ *   tenantLabel       租户概念，出现在参数说明与提示里           默认 组织
+ *   credentialField   注入到工具参数里的凭据字段名               默认 access_token
+ *   hiddenArgs        对模型隐藏的参数（凭据与租户 ID 由本层填） 默认 access_token / orgId
+ *   invalidCodes      表示登录态失效的业务错误码                 默认 613/614/615/616
+ *   loginCommand      登录引导里让模型执行的命令                 默认 mes-login
+ *
+ * 全部有默认值，不配置时行为与改造前完全一致。
+ * 每一项都做了类型校验，配错（null、空串、非数组）时回落默认而不是让服务崩掉。
+ */
+
+/** 系统名默认值 */
+export const DEFAULT_SYSTEM_NAME = 'MES';
+/** 租户称谓默认值 */
+export const DEFAULT_TENANT_LABEL = '组织';
+/** 凭据字段默认名 */
+export const DEFAULT_CREDENTIAL_FIELD = 'access_token';
+/** 租户 ID 字段默认名 */
+export const DEFAULT_TENANT_ID_FIELD = 'orgId';
+/** 默认隐藏的参数：凭据字段 + 租户 ID，实际取自配置 */
+export const DEFAULT_HIDDEN_ARGS = [DEFAULT_CREDENTIAL_FIELD, DEFAULT_TENANT_ID_FIELD];
+/** 默认的登录失效错误码 */
+export const DEFAULT_INVALID_CODES = [613, 614, 615, 616];
+/** 默认登录命令 */
+export const DEFAULT_LOGIN_COMMAND = 'mes-login';
+
+/**
+ * 默认失效码的中文说明
+ *
+ * MES 的语义：613 过期 / 614 解析失败 / 615 被顶下线 / 616 无效。
+ * 别的系统换一套码时，用 invalidCodeReasons 覆盖或补充。
+ */
+export const DEFAULT_INVALID_REASONS = {
+    613: 'token 已过期',
+    614: 'token 解析失败',
+    615: '账号已在别处登录，当前 token 被顶下线',
+    616: 'token 无效'
+};
+
+const isNonEmptyString = (v) => typeof v === 'string' && v.trim().length > 0;
+
+/**
+ * 规范化字符串数组：去掉空项与非字符串，非法输入回落默认
+ */
+function stringList(v, fallback) {
+    if (!Array.isArray(v)) return [...fallback];
+    const list = v.filter(isNonEmptyString).map((s) => s.trim());
+    return list.length ? list : [...fallback];
+}
+
+/**
+ * 规范化错误码数组：只接受有限数字，非法输入回落默认
+ */
+function codeList(v, fallback) {
+    if (!Array.isArray(v)) return [...fallback];
+    const list = [...new Set(v.map((n) => Number(n)).filter((n) => Number.isFinite(n)))];
+    return list.length ? list : [...fallback];
+}
+
+/**
+ * 规范化错误码说明表，与默认值合并（用户只需写要覆盖的项）
+ */
+function reasonMap(v) {
+    if (!v || typeof v !== 'object' || Array.isArray(v)) return { ...DEFAULT_INVALID_REASONS };
+    const out = { ...DEFAULT_INVALID_REASONS };
+    for (const [k, val] of Object.entries(v)) {
+        const code = Number(k);
+        if (Number.isFinite(code) && isNonEmptyString(val)) out[code] = val.trim();
+    }
+    return out;
+}
+
+/**
+ * 取出全部可配置项
+ *
+ * `nameGap` 不是配置项，是排版修正：中文习惯在拉丁字母与汉字之间留空格
+ * （「查询 MES 的组织」），但系统名本身以汉字结尾时再加空格会变成
+ * 「查询 ERP 中台 的租户」，很难看。按末位字符自动决定。
+ *
+ * @param {object|null} cfg 配置对象；为 null 时返回全部默认值
+ * @returns {{
+ *   systemName:string, tenantLabel:string, nameGap:string,
+ *   credentialField:string, hiddenArgs:string[],
+ *   invalidCodes:number[], invalidReasons:Record<number,string>,
+ *   loginCommand:string
+ * }}
+ */
+export function settings(cfg) {
+    const systemName = isNonEmptyString(cfg?.systemName) ? cfg.systemName.trim() : DEFAULT_SYSTEM_NAME;
+    const credentialField = isNonEmptyString(cfg?.credentialField)
+        ? cfg.credentialField.trim()
+        : DEFAULT_CREDENTIAL_FIELD;
+    // 租户 ID 字段：与 orgs[].orgId 的键名对应，本层会把选中租户的值注入进去
+    const tenantIdField = isNonEmptyString(cfg?.tenantIdField)
+        ? cfg.tenantIdField.trim()
+        : DEFAULT_TENANT_ID_FIELD;
+
+    // 默认隐藏「凭据字段 + 租户 ID」：凭据由本层注入，租户 ID 由配置决定，
+    // 露给模型只会引发「我该填什么」的困惑（填了也会被覆盖）。
+    const hiddenArgs = stringList(cfg?.hiddenArgs, [credentialField, tenantIdField]);
+    if (!hiddenArgs.includes(credentialField)) hiddenArgs.push(credentialField);
+
+    return {
+        systemName,
+        tenantLabel: isNonEmptyString(cfg?.tenantLabel) ? cfg.tenantLabel.trim() : DEFAULT_TENANT_LABEL,
+        nameGap: /[A-Za-z0-9]$/.test(systemName) ? ' ' : '',
+        credentialField,
+        tenantIdField,
+        hiddenArgs,
+        invalidCodes: codeList(cfg?.invalidCodes, DEFAULT_INVALID_CODES),
+        invalidReasons: reasonMap(cfg?.invalidCodeReasons),
+        loginCommand: isNonEmptyString(cfg?.loginCommand) ? cfg.loginCommand.trim() : DEFAULT_LOGIN_COMMAND
+    };
+}
+
+/**
+ * 默认值全集，供拿不到配置的场景（CLI 帮助、配置缺失提示）使用
+ */
+export const DEFAULT_SETTINGS = settings(null);

package/lib/token.js

@@ -0,0 +1,61 @@
+/**
+ * token.js —— 只读契约文件（多组织）
+ *
+ * 契约结构见 mes-login-cli/lib/token.js 头部注释。
+ *
+ * 本模块永不写入、永不删除 token.json：
+ * 登录态归 mes-login-cli 管理。桥接层若在 token 失效时删文件，
+ * 会把其他组织刚登录的 token 一起干掉。
+ *
+ * 不本地判断过期：是否失效完全由 MES 的返回码（614/615/616）决定。
+ */
+import fs from 'node:fs';
+import { TOKEN_FILE } from './config.js';
+
+/**
+ * 读取整个契约文件
+ * @returns {{current:string|null, orgs:Object}}
+ */
+export function readStore() {
+    try {
+        if (!fs.existsSync(TOKEN_FILE)) return { current: null, orgs: {} };
+        const data = JSON.parse(fs.readFileSync(TOKEN_FILE, 'utf8'));
+        if (!data || typeof data !== 'object') return { current: null, orgs: {} };
+        return {
+            current: data.current || null,
+            orgs: data.orgs && typeof data.orgs === 'object' ? data.orgs : {}
+        };
+    } catch (e) {
+        // 文件损坏或正在被替换，按未登录处理，下次调用会重新读
+        return { current: null, orgs: {} };
+    }
+}
+
+/**
+ * 取某个组织的登录态
+ * @param {string} orgKey
+ * @returns {{token:string, username:string, orgName:string, path:string}|null}
+ */
+export function getOrgAuth(orgKey) {
+    if (!orgKey) return null;
+    const store = readStore();
+    const auth = store.orgs[orgKey];
+    return auth && auth.token ? auth : null;
+}
+
+/**
+ * 当前生效组织的 key（最后一次登录的组织）
+ */
+export function getCurrentOrgKey() {
+    const store = readStore();
+    if (store.current && store.orgs[store.current]) return store.current;
+    const keys = Object.keys(store.orgs);
+    return keys.length ? keys[0] : null;
+}
+
+/**
+ * 列出所有已登录的组织 key
+ */
+export function listLoggedInOrgs() {
+    return Object.keys(readStore().orgs);
+}

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "mcp-multi-bridge",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.1.0",
+  "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"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "bridge",
+    "multi-tenant",
+    "multi-backend",
+    "mes"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.2"
+  }
+}