mcp-multi-bridge 2.3.0 → 2.3.1

package/README.md

@@ -130,7 +130,20 @@ call_tool                 调用任意工具
 ```
 
 `search_tools` 的返回只给「名称 + 一句话 + 前几个参数名」，不给完整 schema——
-一个完整 schema 就几百 token，一次返回 5 个等于回到全量暴露。需要细节时走 `describe_tool`。
+一个完整 schema 就几百 token，一次返回 10 个就等于回到全量暴露。需要细节时走 `describe_tool`。
+
+**命中多个时不自动挑一个。** bridge 不知道上下文：用户说「物料」可能是查也可能是建，
+猜错会调错工具、产生副作用（误删数据是最坏情况）。所以按分数排好后交给模型选。
+
+返回条数默认 5，可传 `limit`，**上限 10**。上限卡在 10 是因为：
+一次返回太多，模型的选择准确率会下降，而且每条结果都占上下文。
+需要看更多时应该收窄查询词，而不是调大 limit。
+
+排序依据三层：
+
+1. 文本相关度 —— 名称命中 > 参数名命中 > 描述命中
+2. 意图加权 —— 「料号」偏向读操作，「创建料号」偏向写操作
+3. 名称字典序 —— 完全平票时的兜底，保证同样查询返回同样顺序
 
 实测 1200 个工具（6 套系统 × 200）：
 

package/bin.js

@@ -628,7 +628,7 @@ function metaTools(items, bySystem, tenantLabel) {
                 properties: {
                     query: { type: 'string', description: '检索词。中英文都可以，描述你要做的事或涉及的业务对象' },
                     system: { type: 'string', description: '可选，只在某套系统内搜索。留空则搜全部' },
-                    limit: { type: 'number', description: '返回条数，默认 5，最多 20' }
+                    limit: { type: 'number', description: '返回条数，默认 5，最多 10' }
                 },
                 required: ['query']
             }

package/lib/toolindex.js

@@ -340,13 +340,20 @@ function actionBonus(query, name) {
  * 匹配依据只认三处：工具名、描述、参数名。缺中文就去补描述，
  * 不在桥接层维护一张注定对不齐的词表。
  *
+ * 命中多个时按分数排序取前 N 个，不自动挑一个——bridge 不知道上下文，
+ * 用户说「物料」可能是查也可能是建，猜错会调错工具、产生副作用。
+ * 选择权留给模型。
+ *
+ * 上限 10：一次返回太多，模型的选择准确率会下降，
+ * 而且每条结果都占上下文。需要更多时应该收窄查询词。
+ *
  * @param {Map} items buildIndex 返回的 items
  * @param {string} query 检索词
  * @param {{system?:string, limit?:number}} opts
  */
 export function searchTools(items, query, opts = {}) {
     const q = String(query || '').trim();
-    const limit = Math.max(1, Math.min(50, opts.limit || 5));
+    const limit = Math.max(1, Math.min(10, opts.limit || 5));
     if (!q) return [];
 
     const qTokens = tokenize(q);

package/package.json

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