beacon-mfg-mcp 1.12.0 → 1.12.2

package/README.md

@@ -1,5 +1,7 @@
 # Beacon-MFG 只读 MCP 服务
 
+**English**: Read-only MCP server for finding **Chinese suppliers, manufacturers and business entities** — 210k+ records across all GB/T 4754 industries, bilingual CN/EN, USCC-verified, with an RFQ sourcing kernel. Free, no API key: `npx -y beacon-mfg-mcp`.
+
 让任意支持 MCP 的主流 agent（Claude Desktop / Cline / Continue / 常见 MCP 客户端 等）能够**检索与调用**
 灯塔工厂供应商名录，**无需 clone 整个仓库、无需任何密钥、无需第三方依赖**。
 
@@ -8,7 +10,7 @@
 > 只记「怎么绕开」，不评数据对错；repo 模式存 `<repo>/mcp/notes/` 由操作员托管，
 > 联网模式存本机 `~/.beacon-mfg/notes/` 不上传云端）。
 
-## 提供的 tool（8 个只读 + 1 个身份自助 + 1 个入驻入口 + 踩坑留言区读写）
+## 提供的 tool（共 12 个：8 个只读检索 + 1 个身份自助 + 1 个入驻入口 + 2 个留言区读写）
 
 | tool | 用途 | 关键参数 |
 |------|------|----------|
@@ -21,6 +23,7 @@
 | `answer_sourcing` | 续接澄清轮次：写回客户答案，返回下一轮澄清问题或初选供应商列表 | `session_id`（必填） `answers` |
 | `refine_sourcing` | 推荐轮次交互：`details`(看详情与 RFQ 入口) / `more`(看更多) / `best`(看最匹配一家) | `session_id`（必填） `action` `value` |
 | `account` | 查看档位/剩余额度；`request`+`confirm` 绑手机号升 `verified`；`logout` 回匿名 | `action` `phone` `code` |
+| `vendor_onboarding` | 给供应商开通「入驻 / 认领」入口：返回可直接点开的控制台链接与步骤，并附 `agent_channel`（契约 v3.0，非 App 的 HTTP/JSON 自助通道）。**只给入口不代办**：该通道需手机验证码登录，认领前还须通过「登录手机号 = 工商登记法人手机号」一致性核查；验证码由用户本人输入，本工具不发写请求、不持有密钥 | `supplier_id` `company` `intent`（claim/register/status/agent） |
 | `read_notes` | 读踩坑留言区：其他 agent 踩过的坑与绕行（429 语义、无区级过滤、批量取数姿势…）。检索前先读一眼省试错成本 | `topic`（默认 mcp） |
 | `report_note` | 写踩坑留言区：把自己**实测踩到**的坑（现象 + 绕行）回写给后来的 agent。必须真实踩到才写，不当反馈箱/评分区用 | `issue`（必填） `workaround` `agent` `topic` |
 
@@ -153,7 +156,7 @@ MCP_PORT=8787 python http_server.py      # 默认 0.0.0.0:8787，端点 /mcp，
 
 | 变量 | 作用 |
 |---|---|
-| `BEACON_REPO` | 指定含 `data/` 的本地目录，改走本地只读模式（维护者用，分发仓库不含数据） |
+| `BEACON_REPO` | 指定含 `data/` 的本地目录，改走本地只读模式（默认走线上服务） |
 | `BEACON_SOURCE` | 覆盖默认数据源基址（HTTP 模式） |
 | `BEACON_MIRRORS` | 追加备用基址（逗号分隔），主源不可达时自动回退 |
 | `BEACON_MASK_PHONE` | 置 `1` 时对手机号隐私处理输出 |

package/bin/beacon-mfg-mcp.js

@@ -1,58 +1,58 @@
 #!/usr/bin/env node
-'use strict';
-// beacon-mfg-mcp 启动器：本 MCP 服务是纯 Python 标准库实现，这里只负责
-// ① 在用户机器上找到 Python 解释器并拉起 server.py（stdio 协议）
-// ② 顺手踢一个**独立进程**去做节流的自更新检查
-const { spawnSync, spawn } = require('child_process');
-const path = require('path');
-
-const serverPy = path.join(__dirname, '..', 'server.py');
-const selfUpdateJs = path.join(__dirname, 'selfupdate.js');
-
-// 踢起自更新检查：detached + unref，主进程既不等它也不被它拖住。
-// 为什么必须是独立进程而不是本进程里的 async 函数：
-// 下面 spawnSync 是**同步阻塞**的，会冻结整个事件循环 —— async 的自更新
-// 在 server 运行期间推不动，等它能跑时本进程已经 process.exit() 了，
-// 更新逻辑永远跑不完。独立进程不受此影响。
-// 失败、离线、没权限一律静默：它只影响「下次启动是不是最新版」。
-try {
-  const u = spawn(process.execPath, [selfUpdateJs], {
-    stdio: 'ignore',
-    detached: true,
-    windowsHide: true,
-  });
-  u.on('error', () => { /* 没有 node？不可能，自身就是 node 起的 */ });
-  u.unref();
-} catch (_) { /* 自更新是加分项，绝不能影响 MCP 启动 */ }
-
-// 探测可用的 Python 解释器（优先 python3，兼容 python / py）
-const candidates = ['python3', 'python', 'py'];
-let chosen = null;
-for (const c of candidates) {
-  const r = spawnSync(c, ['--version'], { stdio: 'ignore' });
-  if (r.status === 0) {
-    chosen = c;
-    break;
-  }
-}
-if (!chosen) {
-  process.stderr.write(
-    '[beacon-mfg-mcp] 未找到 Python 3。请先安装 Python 3.8+ 并加入 PATH，再重试。\n'
-  );
-  process.exit(1);
-}
-
-const child = spawnSync(chosen, [serverPy, ...process.argv.slice(2)], {
-  stdio: 'inherit',
-  // 显式锁定 UTF-8：中文 Windows 上 python 默认按 GBK 写 stdout，
-  // MCP 客户端按 UTF-8 解码会乱码。从启动器层面保证子进程用 UTF-8 输出。
-  env: Object.assign({}, process.env, {
-    PYTHONUTF8: '1',
-    PYTHONIOENCODING: 'utf-8',
-    // 不写 __pycache__：本服务由 npm 全局安装、跑在任意用户机器上，
-    // 字节码会落进包目录（或只读盘上 EPERM 报错）。服务是短命进程，
-    // 字节码缓存无收益，关掉更干净。
-    PYTHONDONTWRITEBYTECODE: '1',
-  }),
-});
-process.exit(child.status === null ? 1 : child.status);
+'use strict';
+// beacon-mfg-mcp 启动器：本 MCP 服务是纯 Python 标准库实现，这里只负责
+// ① 在用户机器上找到 Python 解释器并拉起 server.py（stdio 协议）
+// ② 顺手踢一个**独立进程**去做节流的自更新检查
+const { spawnSync, spawn } = require('child_process');
+const path = require('path');
+
+const serverPy = path.join(__dirname, '..', 'server.py');
+const selfUpdateJs = path.join(__dirname, 'selfupdate.js');
+
+// 踢起自更新检查：detached + unref，主进程既不等它也不被它拖住。
+// 为什么必须是独立进程而不是本进程里的 async 函数：
+// 下面 spawnSync 是**同步阻塞**的，会冻结整个事件循环 —— async 的自更新
+// 在 server 运行期间推不动，等它能跑时本进程已经 process.exit() 了，
+// 更新逻辑永远跑不完。独立进程不受此影响。
+// 失败、离线、没权限一律静默：它只影响「下次启动是不是最新版」。
+try {
+  const u = spawn(process.execPath, [selfUpdateJs], {
+    stdio: 'ignore',
+    detached: true,
+    windowsHide: true,
+  });
+  u.on('error', () => { /* 没有 node？不可能，自身就是 node 起的 */ });
+  u.unref();
+} catch (_) { /* 自更新是加分项，绝不能影响 MCP 启动 */ }
+
+// 探测可用的 Python 解释器（优先 python3，兼容 python / py）
+const candidates = ['python3', 'python', 'py'];
+let chosen = null;
+for (const c of candidates) {
+  const r = spawnSync(c, ['--version'], { stdio: 'ignore' });
+  if (r.status === 0) {
+    chosen = c;
+    break;
+  }
+}
+if (!chosen) {
+  process.stderr.write(
+    '[beacon-mfg-mcp] 未找到 Python 3。请先安装 Python 3.8+ 并加入 PATH，再重试。\n'
+  );
+  process.exit(1);
+}
+
+const child = spawnSync(chosen, [serverPy, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  // 显式锁定 UTF-8：中文 Windows 上 python 默认按 GBK 写 stdout，
+  // MCP 客户端按 UTF-8 解码会乱码。从启动器层面保证子进程用 UTF-8 输出。
+  env: Object.assign({}, process.env, {
+    PYTHONUTF8: '1',
+    PYTHONIOENCODING: 'utf-8',
+    // 不写 __pycache__：本服务由 npm 全局安装、跑在任意用户机器上，
+    // 字节码会落进包目录（或只读盘上 EPERM 报错）。服务是短命进程，
+    // 字节码缓存无收益，关掉更干净。
+    PYTHONDONTWRITEBYTECODE: '1',
+  }),
+});
+process.exit(child.status === null ? 1 : child.status);