@leadfund/lead-mcp 202610.1.0 → 202610.2.0

package/README.md

@@ -9,6 +9,18 @@
 - 只提供只读工具，不含任何写操作
 - 日志一律走 stderr（stdio 传输下 stdout 是 JSON-RPC 通道）
 
+## ⚠️ 使用前提
+
+**必须在公司网络或已连接 VPN 的环境下使用。**
+
+本包发布在公共 npm 上，任何人都能安装；但**后端 dmmp-system（275）部署在公司内网**，
+`10.1.1.197` / `10.32.30.208` / `10.32.30.209` 公网不可路由。
+
+- 包能正常下载安装 ✓
+- 但脱离内网后查询会超时失败（生产双节点会依次尝试后报错）
+
+包本身不含任何凭证，脱离内网也无法访问到客户数据。
+
 ## 工具
 
 | 工具 | 说明 |
@@ -72,61 +84,133 @@ npm install
 
 ## 接入 Claude Code
 
+### stdio 方式（本地 MCP Client）
+
 ```bash
 claude mcp add-json lead-mcp '{
   "command": "npx",
-  "args": ["-y", "@leadfund/lead-mcp", "--env", "sit", "--operator", "E10086"]
+  "args": ["-y", "--registry=https://registry.npmjs.org/", "@leadfund/lead-mcp", "--env", "sit"],
+  "env": {"LEAD_MCP_ENV": "sit"}
 }'
 ```
 
-### 环境
+### 指定服务地址
 
-| 环境 | 服务地址 |
-|---|---|
-| `local` | `http://localhost:8081` |
-| `sit` | `http://10.1.1.197:8081` |
-| `prd` | `http://10.32.30.208:8081`、`http://10.32.30.209:8081` |
+服务地址**不在包里**，由使用方指定。两种方式：
 
-- 默认环境是 `local` —— 打错环境名不至于直接连到生产。
-- **未知环境名直接报错退出**，不会静默回落到默认环境。
-- 生产是双节点：只有网络错误、超时、5xx 这类「节点不可用」才会自动切到下一个节点；
-  查不到、参数错误这类业务失败不切换，直接返回。
-- 上次成功的节点会被记住并优先使用，避免每次都从第一个节点试探。
+**方式一：命令行参数（支持多个，逗号分隔）**
 
-配置项：
+```bash
+# 单个
+lead-mcp --base-url http://10.1.1.197:8081
 
-| 配置 | 来源 | 默认值 |
-|---|---|---|
-| `--env` / `LEAD_MCP_ENV` | 命令行 / 环境变量 | `local` |
-| `--base-url` / `LEAD_MCP_BASE_URL` | 命令行 / 环境变量 | 无（用 `--env` 的地址） |
-| `--timeout` / `LEAD_MCP_TIMEOUT_MS` | 命令行 / 环境变量 | `10000` |
-| `--token` / `LEAD_MCP_TOKEN` | 命令行 / 环境变量 | 无 |
-| `--operator` / `LEAD_MCP_OPERATOR` | 命令行 / 环境变量 | 无配置时退化为操作系统账号 |
+# 多个（按顺序故障转移，前一个不通自动切下一个）
+lead-mcp --base-url http://10.32.30.208:8081,http://10.32.30.209:8081
+```
+
+也可以用环境变量 `LEAD_MCP_BASE_URL`。**`--base-url` 优先级高于 `--env`。**
+
+**方式二：用户配置文件**（推荐，环境多时更清晰）
+
+默认路径 `~/.lead-mcp/config.json`，可用 `LEAD_MCP_CONFIG` 指定别处：
+
+```json
+{
+  "defaultEnvironment": "sit",
+  "environments": {
+    "local": ["http://localhost:8081"],
+    "sit": ["http://10.1.1.197:8081"],
+    "prd": ["http://10.32.30.208:8081", "http://10.32.30.209:8081"]
+  }
+}
+```
+
+之后用 `--env sit` / `--env prd` 引用；不写 `--env` 就用 `defaultEnvironment`。
+配置文件缺失时只有内置的 `local` 可用。
+
+```bash
+lead-mcp --env prd
+```
+
+### 为什么指定官方源
 
-> `--base-url` 保留，且**优先级高于 `--env`**，逗号分隔多个地址时同样按顺序故障转移：
-> `--base-url http://a:8081,http://b:8081`
+```json
+"args": ["-y", "--registry=https://registry.npmjs.org/", "@leadfund/lead-mcp"]
+```
+
+npm 默认走淘宝源（`registry.npmmirror.com`），而**镜像源对新发布的包有同步延迟**——
+本包发布后淘宝源一度返回 404，导致 `npx` 装上却没有 bin，报 `lead-mcp: command not found`。
+显式指定官方源可以完全避开这个问题（官方源是源，镜像只是它的副本）。
+
+### operator 要不要配
+
+**默认不用配。** 没传 `--operator` 时，Server 会自动用操作系统账号（`os.userInfo().username`）作为操作人，
+限流维度和审计记录都有值。
+
+想要审计里直接是工号而不是机器账号，才需要显式配置：
 
-> 密钥类配置请走环境变量，不要写进 MCP 配置文件——`claude mcp add-json` 的内容会明文落到 `~/.claude.json`。
+```json
+"args": ["-y", "--registry=https://registry.npmjs.org/", "@leadfund/lead-mcp", "--env", "sit", "--operator", "E10086"]
+```
+
+## HTTP(S) 模式（云端 MCP 服务）
+
+stdio 只适用于本地 MCP Client。要接入云端服务（如阿里云百炼），用 HTTP 模式。
 
-### 调用方身份与环境
+### 启动
+
+```bash
+# SSE 协议
+lead-mcp --transport sse --http-port 3100 --http-host 0.0.0.0 \
+  --auth-token <你的token> --env sit
 
-MCP 协议本身不传递登录身份，本 Server 会把操作人信息与环境标识放进请求头带给后端：
+# Streamable HTTP 协议
+lead-mcp --transport http --http-port 3100 --http-host 0.0.0.0 \
+  --auth-token <你的token> --env sit
+```
 
-| 请求头 | 来源 | 用途 |
+| 传输 | 端点 | 说明 |
 |---|---|---|
-| `X-Operator` | `--operator` / `LEAD_MCP_OPERATOR`，未配置时为操作系统账号 | 服务端限流维度 + 审计记录 |
-| `X-Operator-Os` | 操作系统账号（`os.userInfo().username`） | 便于后端把 OS 账号二次解析成工号 |
-| `X-Lead-Env` | 当前环境（`local` / `sit` / `prd` / `custom`） | 审计里区分查询打在哪个环境 |
+| `stdio` | — | 默认，本地 MCP Client |
+| `sse` | `GET /sse` + `POST /messages?sessionId=` | 云端 MCP 常用 |
+| `http` | `POST /mcp` | Streamable HTTP，一站式 |
+
+**HTTP 模式下 `--auth-token` 必填**（没有令牌直接拒绝启动）—— 这套服务通常要暴露到公网，
+不设令牌等于不设防。客户端通过 `Authorization: Bearer <token>` 认证。
+`GET /health` 不鉴权，方便探活。
+
+### 百炼云端配置
+
+```json
+{
+  "type": "mcp",
+  "server_protocol": "sse",
+  "server_label": "lead-mcp",
+  "server_url": "https://你的域名/sse",
+  "headers": { "Authorization": "Bearer 你的token" }
+}
+```
+
+`server_protocol` 换成 `http` 时，`server_url` 用 `https://你的域名/mcp`。
 
-**建议显式配置工号**，否则审计里只能看到操作系统账号：
+### 暴露到公网（ng 隧道示例）
 
 ```bash
-claude mcp add-json lead-mcp '{
-  "command": "npx",
-  "args": ["-y", "@leadfund/lead-mcp", "--env", "sit", "--operator", "E10086"]
-}'
+lead-mcp --transport sse --http-host 0.0.0.0 --http-port 3100 \
+  --auth-token <你的token> --env sit
+
+# 另一个终端
+ng http 3100
+# 拿到 https://xxxx.ngrok-free.app
 ```
 
+然后百炼里填 `https://xxxx.ngrok-free.app/sse` 和 Bearer 令牌。
+
+> ⚠️ 暴露到公网前请确认：
+> - `--auth-token` 已配置且足够随机
+> - 后端地址走 `--env` 指向内网，**不要**把 275 的直连地址暴露出去
+> - ng 隧道是临时地址，重启会变
+
 ## 本地调试
 
 ```bash
@@ -139,9 +223,15 @@ npx @modelcontextprotocol/inspector node src/cli.js --base-url http://127.0.0.1:
 ### 测试
 
 ```bash
-npm test        # 配置解析单元测试 + 端到端冒烟测试
+npm test        # 配置解析单元测试 + HTTP 端到端 + 冒烟测试
+node test/e2e-published.mjs [手机号]   # 用公网已发布的包跑真实链路（默认 sit）
 ```
 
+> ⚠️ **在本包源码目录下不要用 `npx` 启动**：npx 会把本地 `package.json` 当作「已安装」，
+> 直接去找 `node_modules/.bin/lead-mcp`，而它不是自己的依赖、软链不存在，
+> 结果是 `sh: lead-mcp: command not found`（exit 127）。
+> 开发时用 `node src/cli.js`，或换到别的目录执行。
+
 - `test/config.test.mjs` —— 环境选择、地址优先级、未知环境报错等纯逻辑
 - `test/smoke.mjs` —— 拉起 mock 的 dmmp-system，再以子进程方式拉起真实的 MCP Server，
   走完整协议握手，覆盖命中 / 未命中 / 多会员 / 参数非法 / 下游异常 / 操作人透传 /
@@ -171,13 +261,17 @@ MES MemberQueryFacade
 lead-mcp/
 ├── package.json
 ├── src/
-│   ├── cli.js       # 入口，stdio 传输
+│   ├── cli.js       # 入口，按 transport 分派
+│   ├── http.js      # HTTP(S) 传输：SSE / Streamable HTTP
 │   ├── server.js    # MCP Server 与工具注册
 │   ├── client.js    # dmmp-system HTTP 客户端
 │   ├── config.js    # 配置解析
 │   └── logger.js    # stderr 日志
 └── test/
-    └── smoke.mjs    # 端到端冒烟测试
+    ├── config.test.mjs   # 配置解析单元测试
+    ├── http.test.mjs     # HTTP(S) 传输端到端测试
+    ├── smoke.mjs         # 端到端冒烟测试
+    └── e2e-published.mjs # 用公网已发布的包跑真实链路
 ```
 
 ## 约束
@@ -186,3 +280,5 @@ lead-mcp/
 - **日志走 stderr**：写 stdout 会破坏 JSON-RPC 协议。
 - **脱敏在服务端完成**：本项目不做脱敏，直接透传后端已脱敏的结果。
 - **限流在服务端做**：客户端侧计数可被绕过，服务端按「操作人」和「查询目标」两个维度限流。
+- **包内不含内网地址**：服务地址由使用方通过 `--base-url` 或 `~/.lead-mcp/config.json` 指定。
+- **HTTP 模式必须带令牌**：`--auth-token` 未配置时直接拒绝启动。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leadfund/lead-mcp",
-  "version": "202610.1.0",
+  "version": "202610.2.0",
   "description": "利得零售系统 MCP Server —— 客户账户信息只读查询",
   "type": "module",
   "bin": {
@@ -18,9 +18,10 @@
   "scripts": {
     "start": "node src/cli.js",
     "inspector": "npx @modelcontextprotocol/inspector node src/cli.js",
-    "test": "node test/config.test.mjs && node test/smoke.mjs",
+    "test": "node test/config.test.mjs && node test/http.test.mjs && node test/smoke.mjs",
     "smoke": "node test/smoke.mjs",
-    "release": "npm test && npm publish --registry=https://registry.npmjs.org/ --access public"
+    "release": "npm test && npm publish --registry=https://registry.npmjs.org/ --access public",
+    "test:http": "node test/http.test.mjs"
   },
   "publishConfig": {
     "access": "public",
@@ -36,5 +37,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^3.25.76 || ^4.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "http://10.1.1.90/root/lead-mcp.git"
+  },
+  "homepage": "http://10.1.1.90/root/lead-mcp",
+  "bugs": {
+    "url": "http://10.1.1.90/root/lead-mcp/-/issues"
   }
 }

package/src/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { USAGE, isHelpRequested, loadConfig } from "./config.js";
+import { startHttpServer } from "./http.js";
 import { logger } from "./logger.js";
 import { createServer } from "./server.js";
 
@@ -12,12 +13,19 @@ async function main() {
   }
 
   const config = loadConfig();
-  const server = createServer(config);
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  logger.info(
-    `已启动，环境=${config.env}，服务地址=${config.baseUrls.join(", ")}，超时=${config.timeoutMs}ms`,
-  );
+
+  if (config.transport === "stdio") {
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info(
+      `已启动（stdio），环境=${config.env}，服务地址=${config.baseUrls.join(", ")}，超时=${config.timeoutMs}ms`,
+    );
+    return;
+  }
+
+  // HTTP 模式常驻，直到进程被结束
+  await startHttpServer(config);
 }
 
 main().catch((error) => {

package/src/config.js

@@ -1,71 +1,128 @@
+import fs from "node:fs";
 import os from "node:os";
+import path from "node:path";
 
 /**
  * 运行配置
  *
- * <p>配置来源优先级：命令行参数 &gt; 环境变量 &gt; 默认值。</p>
+ * <p>配置来源优先级：命令行参数 &gt; 环境变量 &gt; 用户配置文件 &gt; 内置默认值。</p>
+ *
+ * <p><b>服务地址不在包里</b>：包内只保留 local 默认地址，
+ * sit / prd 等环境地址由使用方在自己的配置文件
+ * {@code ~/.lead-mcp/config.json} 或 {@code --base-url} 里指定。</p>
  */
 
 /**
  * @typedef {Object} LeadMcpConfig
- * @property {string} env 环境标识：local / sit / prd / custom
+ * @property {string} env 环境标识，会随请求透传给后端用于审计
  * @property {string[]} baseUrls dmmp-system（系统 id 275）服务地址列表，多个时按顺序故障转移
  * @property {number} timeoutMs 单次请求超时（毫秒）
  * @property {string|undefined} token 访问令牌，可选
  * @property {string|undefined} operator 操作人标识（工号），用于服务端限流与审计
  * @property {string|undefined} operatorOs 操作人操作系统账号
+ * @property {"stdio"|"sse"|"http"} transport 传输方式
+ * @property {number} httpPort HTTP 监听端口
+ * @property {string} httpHost HTTP 监听地址
+ * @property {string} httpPath HTTP 端点路径
+ * @property {string|undefined} authToken HTTP 访问令牌（Bearer），HTTP 模式下必填
  */
 
 /**
- * 各环境的服务地址
+ * 内置环境
  *
- * <p>生产为双节点，客户端会按顺序故障转移，避免单点故障导致工具不可用。</p>
+ * <p>只保留本地开发地址。内网地址一律由使用方配置，避免随包公开。</p>
  */
-export const ENVIRONMENTS = {
+export const BUILTIN_ENVIRONMENTS = {
   local: {
     label: "本地开发",
     baseUrls: ["http://localhost:8081"],
   },
-  sit: {
-    label: "集成测试",
-    baseUrls: ["http://10.1.1.197:8081"],
-  },
-  prd: {
-    label: "生产",
-    baseUrls: ["http://10.32.30.208:8081", "http://10.32.30.209:8081"],
-  },
 };
 
-/**
- * 默认环境
- *
- * <p>默认走 local：打错环境名不至于直接连到生产。</p>
- */
 export const DEFAULT_ENV = "local";
-
 export const DEFAULT_TIMEOUT_MS = 10000;
+export const DEFAULT_HTTP_PORT = 3100;
+export const DEFAULT_HTTP_HOST = "127.0.0.1";
+
+/**
+ * 传输方式
+ */
+export const TRANSPORTS = ["stdio", "sse", "http"];
 
 export const USAGE = `lead-mcp —— 利得零售系统 MCP Server
 
 用法：
   lead-mcp [选项]
 
-选项：
-  --env <环境>         目标环境，默认 ${DEFAULT_ENV}
-                       ${Object.entries(ENVIRONMENTS)
-                         .map(([name, env]) => `${name}(${env.label}) ${env.baseUrls.join(",")}`)
-                         .join("\n                       ")}
-                       也可用环境变量 LEAD_MCP_ENV；未知环境名会直接报错退出
+服务地址（dmmp-system 275）
+  --env <环境>         目标环境名，从用户配置文件的 environments 里取
+                       也可用环境变量 LEAD_MCP_ENV
   --base-url <url>     直接指定服务地址，逗号分隔多个时按顺序故障转移
                        优先级高于 --env，也可用环境变量 LEAD_MCP_BASE_URL
+                       例：--base-url http://10.1.1.197:8081
+                           --base-url http://a:8081,http://b:8081
+
+传输方式
+  --transport <方式>   stdio（默认，本地 MCP Client）/ sse / http
+                       也可用环境变量 LEAD_MCP_TRANSPORT
+  --http-port <端口>   HTTP 监听端口，默认 ${DEFAULT_HTTP_PORT}
+  --http-host <地址>   HTTP 监听地址，默认 ${DEFAULT_HTTP_HOST}
+                       需要对外暴露时传 0.0.0.0
+  --http-path <路径>   HTTP 端点路径，默认 sse 用 /sse、http 用 /mcp
+  --auth-token <token> HTTP 访问令牌，HTTP 模式下必填（Bearer 认证）
+                       也可用环境变量 LEAD_MCP_AUTH_TOKEN
+
+通用
   --timeout <ms>       单次请求超时毫秒数，默认 ${DEFAULT_TIMEOUT_MS}
-                       也可用环境变量 LEAD_MCP_TIMEOUT_MS
-  --token <token>      访问令牌，可选，也可用环境变量 LEAD_MCP_TOKEN
-  --operator <工号>    操作人标识，用于服务端限流与审计
-                       也可用环境变量 LEAD_MCP_OPERATOR；未配置时退化为操作系统账号
+  --token <token>      dmmp-system 访问令牌，可选
+  --operator <工号>    操作人标识，用于服务端限流与审计；不配置则用操作系统账号
   -h, --help           查看帮助
+
+用户配置文件（默认 ~/.lead-mcp/config.json，可用 LEAD_MCP_CONFIG 指定）：
+  {
+    "defaultEnvironment": "sit",
+    "environments": {
+      "sit": ["http://10.1.1.197:8081"],
+      "prd": ["http://10.32.30.208:8081", "http://10.32.30.209:8081"]
+    }
+  }
 `;
 
+/**
+ * 配置文件路径
+ *
+ * @returns {string} 路径
+ */
+export function resolveConfigFile() {
+  return (
+    process.env.LEAD_MCP_CONFIG ??
+    path.join(os.homedir(), ".lead-mcp", "config.json")
+  );
+}
+
+/**
+ * 读取用户配置文件
+ *
+ * @returns {{defaultEnvironment?: string, environments?: Record<string, string[]>}} 配置
+ * @throws {Error} 配置文件存在但格式非法
+ */
+export function loadUserConfig() {
+  const file = resolveConfigFile();
+  try {
+    const raw = fs.readFileSync(file, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") {
+      throw new Error("格式必须是 JSON 对象");
+    }
+    return parsed;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return {};
+    }
+    throw new Error(`读取配置文件失败 ${file}：${error.message}`);
+  }
+}
+
 /**
  * 解析操作人的操作系统账号
  *
@@ -108,23 +165,6 @@ export function parseArgs(argv) {
   return result;
 }
 
-/**
- * 归一化环境名并校验
- *
- * @param {string} name 环境名
- * @returns {string} 环境名
- * @throws {Error} 环境名非法
- */
-export function normalizeEnv(name) {
-  const env = String(name).trim().toLowerCase();
-  if (!ENVIRONMENTS[env]) {
-    throw new Error(
-      `未知环境 "${name}"，可选值：${Object.keys(ENVIRONMENTS).join(" / ")}`,
-    );
-  }
-  return env;
-}
-
 /**
  * 解析服务地址列表
  *
@@ -138,32 +178,90 @@ export function splitBaseUrls(value) {
     .filter((item) => item.length > 0);
 }
 
+/**
+ * 解析传输方式
+ *
+ * @param {string} name 传输方式
+ * @returns {"stdio"|"sse"|"http"} 传输方式
+ * @throws {Error} 非法
+ */
+export function normalizeTransport(name) {
+  const transport = String(name).trim().toLowerCase();
+  if (!TRANSPORTS.includes(transport)) {
+    throw new Error(`未知传输方式 "${name}"，可选值：${TRANSPORTS.join(" / ")}`);
+  }
+  return transport;
+}
+
 /**
  * 加载配置
  *
  * @param {string[]} [argv]
  * @returns {LeadMcpConfig}
- * @throws {Error} 环境名非法
+ * @throws {Error} 配置非法
  */
 export function loadConfig(argv = process.argv.slice(2)) {
   const args = parseArgs(argv);
+  const userConfig = loadUserConfig();
 
   const rawEnv = args.get("env") ?? process.env.LEAD_MCP_ENV;
   const rawBaseUrl = args.get("base-url") ?? process.env.LEAD_MCP_BASE_URL;
   const hasBaseUrl = Boolean(rawBaseUrl) && rawBaseUrl !== "true";
 
-  // 环境名非法直接失败：静默回落到默认环境可能把请求打到错误的环境
-  const env =
-    rawEnv && rawEnv !== "true"
-      ? normalizeEnv(rawEnv)
-      : hasBaseUrl
-        ? "custom"
-        : DEFAULT_ENV;
-
-  // 显式指定的地址优先级更高，可直接指定多个做故障转移
-  const baseUrls = hasBaseUrl ? splitBaseUrls(rawBaseUrl) : ENVIRONMENTS[env].baseUrls;
-  if (baseUrls.length === 0) {
-    throw new Error("没有可用的服务地址，请检查 --env / --base-url 配置");
+  // 解析服务地址：显式地址 > 用户配置的环境 > 内置 local
+  let env;
+  let baseUrls;
+  if (hasBaseUrl) {
+    env = rawEnv && rawEnv !== "true" ? String(rawEnv).trim() : "custom";
+    baseUrls = splitBaseUrls(rawBaseUrl);
+  } else {
+    const envName =
+      (rawEnv && rawEnv !== "true" ? rawEnv : undefined) ??
+      userConfig.defaultEnvironment ??
+      DEFAULT_ENV;
+    const configured = userConfig.environments?.[envName];
+    const builtin = BUILTIN_ENVIRONMENTS[envName];
+    if (!configured && !builtin) {
+      throw new Error(
+        `未知环境 "${envName}"。请在 ${resolveConfigFile()} 的 environments 里配置，` +
+          `或直接用 --base-url 指定地址`,
+      );
+    }
+    env = envName;
+    baseUrls = configured ?? builtin.baseUrls;
+  }
+  if (!Array.isArray(baseUrls) || baseUrls.length === 0) {
+    throw new Error(`环境 "${env}" 没有配置服务地址`);
+  }
+
+  // 传输方式
+  const rawTransport = args.get("transport") ?? process.env.LEAD_MCP_TRANSPORT;
+  const transport = normalizeTransport(
+    rawTransport && rawTransport !== "true" ? rawTransport : "stdio",
+  );
+
+  const portRaw = args.get("http-port") ?? process.env.LEAD_MCP_HTTP_PORT;
+  const httpPort = portRaw ? Number.parseInt(portRaw, 10) : DEFAULT_HTTP_PORT;
+  const hostRaw = args.get("http-host") ?? process.env.LEAD_MCP_HTTP_HOST;
+  const httpHost = hostRaw && hostRaw !== "true" ? hostRaw : DEFAULT_HTTP_HOST;
+  const pathRaw = args.get("http-path");
+  const httpPath =
+    pathRaw && pathRaw !== "true"
+      ? pathRaw
+      : transport === "sse"
+        ? "/sse"
+        : transport === "http"
+          ? "/mcp"
+          : "/mcp";
+
+  const authRaw = args.get("auth-token") ?? process.env.LEAD_MCP_AUTH_TOKEN;
+  const authToken = authRaw && authRaw !== "true" ? authRaw : undefined;
+
+  // HTTP 模式会被暴露到公网（典型是走 ng 隧道），没有令牌等于不设防
+  if (transport !== "stdio" && !authToken) {
+    throw new Error(
+      "HTTP 模式必须配置访问令牌：请用 --auth-token 或环境变量 LEAD_MCP_AUTH_TOKEN",
+    );
   }
 
   const timeoutRaw = args.get("timeout") ?? process.env.LEAD_MCP_TIMEOUT_MS;
@@ -180,6 +278,11 @@ export function loadConfig(argv = process.argv.slice(2)) {
     // 未显式配置工号时退化为操作系统账号，保证服务端审计至少有「谁」
     operator: operator ?? resolveOperatorOs(),
     operatorOs: resolveOperatorOs(),
+    transport,
+    httpPort: Number.isFinite(httpPort) && httpPort > 0 ? httpPort : DEFAULT_HTTP_PORT,
+    httpHost,
+    httpPath,
+    authToken,
   };
 }