@hupan56/wlkj 3.0.0 → 3.1.3

package/templates/qoder/scripts/protocol/mcp/mcp_launcher.py

@@ -0,0 +1,600 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# ⚠️ 本文件会被复制到 ~/.qoderwork/mcp_launcher.py, 在用户主目录运行!
+# 不能依赖仓库内的 bootstrap/common (那里没有), 必须自包含路径定位。
+import os, sys
+
+try:
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except (AttributeError, TypeError, OSError):
+    pass
+
+
+"""
+mcp_launcher.py - 统一 MCP 启动器（跨 Win/Mac/Linux，消除写死路径）
+
+被谁调用:
+  QoderWork 按 ~/.qoderwork/mcp.json 的 command 拉起本脚本。
+  mcp.json 的 args = [<本脚本路径>, <MCP名>]
+  例: {"command": "py", "args": ["C:/Users/HP/.qoderwork/mcp_launcher.py", "kg"]}
+
+为什么需要它:
+  之前 mcp.json 写死绝对路径 (E:\\...\\python.exe + 仓库路径 + venv路径),
+  换电脑/换系统/别人 clone 全废。本 launcher 运行时自定位仓库根 + 找对的 python,
+  mcp.json 只需写 python 命令名 (py/python3) + 本脚本路径 (在 ~/.qoderwork/)。
+
+做什么:
+  1. 解析 argv[1] = MCP 名 (kg / mysql / zentao / lanhu)
+  2. find_repo_root(): 环境变量 QODER_REPO > ~/.qoderwork/.repo-root 文件 > 向上找 .qoder/
+  3. kg/mysql/zentao: 同进程执行 (in-proc) — 直接 import server 模块 + 调 ServerClass().run()。
+     不再用 os.execv! 双冷启动 (launcher python + execv 后新 python) 是 MCP Pool 30s 超时
+     和 Node-spawn 下 os.execv 丢 stdin 的根因, 改 in-proc 后只冷启动 1 次。
+  4. lanhu: 必须用独立 venv 的 python 3.10+ (fastmcp 依赖), 仍 os.execv (venv 内, 无可避免)。
+
+跨平台:
+  find_repo_root 用 os.path, venv python 用 _venv_python (win Scripts/mac bin)。
+  本脚本被 python3/py/python 跑都行 (kg/mysql/zentao 走 in-proc, lanhu 走 execv)。
+"""
+
+import json
+import os
+import sys
+from pathlib import Path
+
+try:
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except (AttributeError, TypeError, OSError):
+    pass
+
+
+def _home():
+    """跨平台 home 目录。"""
+    return Path(os.environ.get('USERPROFILE') or os.path.expanduser('~'))
+
+
+def _log(msg):
+    """调试日志到 stderr (MCP stdio 用 stdout, 不能污染)。"""
+    sys.stderr.write('[mcp-launcher] ' + msg + '\n')
+
+
+def _launch_disabled_mcp(name, reason):
+    """没装/没配时, 启动一个空壳 MCP (只回 initialize + tools/list 空)。
+    让 QoderWork 显示绿(已连接)但无工具, 而不是黄(报错)。
+    reason 写进 serverInfo 让用户知道为什么没工具。"""
+    import json as _j
+    _log(f'{name} MCP 以"未启用"模式启动: {reason}')
+    # 简单的 stdio 循环, 只响应 initialize 和 tools/list
+    while True:
+        try:
+            line = sys.stdin.buffer.readline()
+        except (EOFError, OSError):
+            break
+        if not line:
+            break
+        try:
+            req = _j.loads(line.decode('utf-8'))
+        except Exception:
+            continue
+        method = req.get('method', '')
+        rid = req.get('id')
+        if method == 'initialize':
+            sys.stdout.write(_j.dumps({
+                "jsonrpc": "2.0", "id": rid,
+                "result": {
+                    "protocolVersion": "2024-11-05",
+                    "capabilities": {"tools": {}},
+                    "serverInfo": {"name": name, "version": "0.0.0-disabled",
+                                   "reason": reason}
+                }
+            }) + '\n')
+            sys.stdout.flush()
+        elif method == 'tools/list':
+            sys.stdout.write(_j.dumps({
+                "jsonrpc": "2.0", "id": rid,
+                "result": {"tools": []}
+            }) + '\n')
+            sys.stdout.flush()
+        elif method == 'notifications/initialized':
+            pass
+        elif rid is not None:
+            sys.stdout.write(_j.dumps({
+                "jsonrpc": "2.0", "id": rid,
+                "error": {"code": -32601, "message": reason}
+            }) + '\n')
+            sys.stdout.flush()
+
+
+def find_repo_root():
+    """定位 QODER 仓库根。优先级:
+      1. 环境变量 QODER_REPO (用户显式设, 最可靠)
+      2. ~/.qoderwork/.repo-root 文件 (install 时写)
+      3. 向上找 .qoder/scripts/ (cwd 在仓库内, IDE/CLI 场景)
+      4. 本脚本若在 <repo>/.qoder/scripts/ 下 → 上三级 (开发态)
+    返回 Path 或 None。
+
+    全部失败时打一条 stderr 诊断 (不静默降级为"0 工具绿桩"),
+    让用户知道是"仓库根没定位到"而不是 MCP 崩了。
+    """
+    # 1. 环境变量
+    env_repo = os.environ.get('QODER_REPO')
+    if env_repo and (Path(env_repo) / '.qoder' / 'scripts').is_dir():
+        return Path(env_repo)
+
+    # 2. ~/.qoderwork/.repo-root 文件 (install 写的, 主路径)
+    anchor = _home() / '.qoderwork' / '.repo-root'
+    if anchor.is_file():
+        try:
+            line = anchor.read_text(encoding='utf-8').strip()
+            if line and (Path(line) / '.qoder' / 'scripts').is_dir():
+                return Path(line)
+        except OSError:
+            pass
+
+    # 3. 向上找 .qoder/scripts/
+    here = Path(os.getcwd()).resolve()
+    for _ in range(8):
+        if (here / '.qoder' / 'scripts').is_dir():
+            return here
+        parent = here.parent
+        if parent == here:
+            break
+        here = parent
+
+    # 4. 本脚本位置 (仅当脚本真在 <repo>/.qoder/scripts/ 下时成立)。
+    #    注意: 安装到 ~/.qoderwork/mcp_launcher.py 的副本不能走这步 ——
+    #    s.parent.parent.parent 会解析到用户主目录的父目录(非仓库), 误判。
+    #    必须用 .qoder/scripts 标志位校验, 校验不过就继续找其它线索。
+    try:
+        s = Path(__file__).resolve()
+        # 校验: 本脚本是否真在 .../<repo>/.qoder/scripts/ 结构内
+        if s.parent.name == 'scripts' and s.parent.parent.name == '.qoder':
+            root = s.parent.parent.parent  # scripts/ -> .qoder/ -> repo
+            if (root / '.qoder' / 'scripts').is_dir():
+                return root
+    except Exception:
+        pass
+
+    # 全部失败 → 给清晰诊断, 不让 MCP 静默变 0 工具绿桩
+    _log('find_repo_root: 所有定位策略均失败, MCP 将以禁用桩启动。')
+    _log('  cwd=%s' % os.getcwd())
+    _log('  锚点 %s 存在? %s' % (anchor, anchor.is_file()))
+    _log('  修复: 在项目根目录跑 "npx @hupan56/wlkj init" (会写 .repo-root 锚点),')
+    _log('        或设环境变量 QODER_REPO=<项目根目录> 后重启 QoderWork。')
+    return None
+
+
+def _venv_python(venv):
+    """venv 内 python 路径 (跨平台: win Scripts/python.exe, mac bin/python)。"""
+    if sys.platform == 'win32':
+        return venv / 'Scripts' / 'python.exe'
+    return venv / 'bin' / 'python'
+
+
+def _run_server_inproc(server_path):
+    """同进程运行 MCP server (替代 os.execv)。
+
+    为什么不用 os.execv:
+      ① 双冷启动: launcher 的 Python 冷启动完, execv 又拉起一个新 Python 冷启动,
+         3 个 server 同时启动 + Anaconda 冷启动慢 → MCP Pool 30s 超时 → 黄灯(0 工具)。
+      ② Node.js spawn 下 os.execv 丢 stdin: Windows 上 os.execv 是"新进程"不是真 execv,
+         A 进程 stdin buffer 里的 initialize 字节不会传给 B 进程 → B readline 读到空 → 立即退出。
+      in-proc 在当前进程直接跑 server, 既省一次冷启动又无 stdin 丢失。
+
+    用 runpy.run_path(run_name='__main__') 等价于"直接运行那个 .py 文件":
+      - 会触发 server 顶部的 bootstrap.setup() (路径自举)
+      - 会执行 if __name__ == '__main__': ServerClass().run() (已有, 无需反射找类名)
+      - 比 importlib+反射更简单且不耦合 server 类名 (类改名也不影响 launcher)
+    """
+    import runpy
+    _log('in-proc 运行 %s' % os.path.basename(str(server_path)))
+    runpy.run_path(str(server_path), run_name='__main__')  # 阻塞: stdio 主循环, 直到 stdin 关闭
+
+
+def _read_current_developer(repo):
+    """读 .qoder/.developer 当前角色。"""
+    try:
+        _scripts = str(repo / '.qoder' / 'scripts')
+        if _scripts not in sys.path:
+            sys.path.insert(0, _scripts)
+        from foundation.core.paths import get_developer
+        return get_developer(repo)
+    except Exception:
+        return None
+
+
+def _read_lanhu_cookie(repo, dev):
+    """读角色的蓝湖 cookie。
+
+    M2 子目录化后 setup_lanhu 在 scripts/setup/ 子包, 需把 setup/ 也加进 path。
+    """
+    try:
+        _scripts = str(repo / '.qoder' / 'scripts')
+        _setup_sub = str(repo / '.qoder' / 'scripts' / 'deployment' / 'setup')
+        for _p in (_scripts, _setup_sub):
+            if _p not in sys.path:
+                sys.path.insert(0, _p)
+        from setup_lanhu import _read_env_cookie, lanhu_env_file, COOKIE_PLACEHOLDER
+        ck = _read_env_cookie(dev)
+        return ck if (ck and ck != COOKIE_PLACEHOLDER) else None
+    except Exception:
+        return None
+
+
+def launch_kg(repo):
+    """启动知识图谱 MCP。需 duckdb (本进程 import 即校验)。
+
+    v3.0: in-proc 执行 (替代 os.execv) — 省一次 Python 冷启动 + 消除 Node-spawn 下
+    os.execv 丢 stdin 问题。duckdb 缺失 → 降级空壳。
+    """
+    server = repo / '.qoder' / 'scripts' / 'protocol' / 'mcp' / 'kg_mcp_server.py'
+    if not server.is_file():
+        _log(f'kg server 不存在: {server}')
+        _launch_disabled_mcp('qoder-knowledge-graph',
+            'kg_mcp_server.py 缺失。跑 npx @hupan56/wlkj update')
+        return
+    # 校验 duckdb (本进程 import, 无 subprocess 开销)
+    try:
+        import duckdb  # noqa: F401
+    except ImportError:
+        _log('⚠️ 当前 Python 无 duckdb! 跑: pip install duckdb')
+        _log('  或: npx @hupan56/wlkj install-env')
+        _launch_disabled_mcp('qoder-knowledge-graph',
+            'duckdb 未装。跑 npx @hupan56/wlkj install-env (自动装依赖)')
+        return
+    _log('启动 kg (in-proc)')
+    _run_server_inproc(server)
+
+
+def launch_mysql(repo):
+    """启动 MySQL MCP。连接信息优先从 config.yaml 读 (团队共享, git 里有)。
+    回退: ~/.qoderwork/.mcp-mysql-env.json (旧版个人文件)。"""
+    server = repo / '.qoder' / 'scripts' / 'protocol' / 'mcp' / 'mysql_mcp_server.py'
+    if not server.is_file():
+        _log(f'mysql server 不存在: {server}')
+        _launch_disabled_mcp('qoder-mysql',
+            'mysql_mcp_server.py 缺失。跑 npx @hupan56/wlkj update')
+        return
+    # 优先: 从 config.yaml 读 (团队共享, clone 就有)
+    cfg_path = repo / '.qoder' / 'config.yaml'
+    mysql_cfg = {}
+    if cfg_path.is_file():
+        try:
+            import yaml
+            d = yaml.safe_load(cfg_path.read_text(encoding='utf-8')) or {}
+            mysql_cfg = d.get('mysql', {}) or {}
+        except Exception:
+            pass
+    # 注入策略 (v3.x 多环境): 把全部环境序列化成 JSON 给 server,
+    # server 按工具调用的 env 参数取对应环境建连, 运行时切库。
+    if mysql_cfg.get('environments'):
+        # 新结构: default_env + environments
+        os.environ['MYSQL_ENVIRONMENTS'] = json.dumps(
+            mysql_cfg['environments'], ensure_ascii=False)
+        os.environ['MYSQL_DEFAULT_ENV'] = str(
+            mysql_cfg.get('default_env') or
+            next(iter(mysql_cfg['environments']), 'test'))
+        _log(f'mysql 多环境注入 ({len(mysql_cfg["environments"])} 个环境: '
+             f'{", ".join(mysql_cfg["environments"].keys())})')
+    elif mysql_cfg.get('host'):
+        # 兼容旧扁平结构 → 包成单环境 test
+        os.environ['MYSQL_ENVIRONMENTS'] = json.dumps(
+            {'test': mysql_cfg}, ensure_ascii=False)
+        os.environ['MYSQL_DEFAULT_ENV'] = 'test'
+        _log('mysql 旧扁平结构 → 包成单环境 test')
+    else:
+        # 回退: 旧版个人 env 文件 (~/.qoderwork/.mcp-mysql-env.json)
+        env_file = _home() / '.qoderwork' / '.mcp-mysql-env.json'
+        if env_file.is_file():
+            try:
+                cfg = json.loads(env_file.read_text(encoding='utf-8'))
+                # 旧个人文件是扁平的 MYSQL_HOST/... → 包成单环境 test
+                flat = {k[len('MYSQL_'):].lower(): v for k, v in cfg.items()
+                        if k.startswith('MYSQL_') and v}
+                if flat.get('host'):
+                    if 'env_name' not in flat:
+                        flat['env_name'] = flat.get('host', '')
+                    os.environ['MYSQL_ENVIRONMENTS'] = json.dumps(
+                        {'test': flat}, ensure_ascii=False)
+                    os.environ['MYSQL_DEFAULT_ENV'] = 'test'
+                    _log(f'mysql 个人文件 → 包成单环境 test ({len(flat)} 项)')
+            except (json.JSONDecodeError, OSError):
+                pass
+        if 'MYSQL_ENVIRONMENTS' not in os.environ:
+            _log('⚠️ mysql 配置缺失: config.yaml 无 mysql.environments/host, '
+                 '且 ~/.qoderwork/.mcp-mysql-env.json 不存在')
+    _log(f'启动 mysql (in-proc)')
+    # 校验 pymysql (本进程 import)
+    try:
+        import pymysql  # noqa: F401
+    except ImportError:
+        _log('⚠️ 当前 Python 无 pymysql! 跑: pip install pymysql')
+        _launch_disabled_mcp('qoder-mysql',
+            'pymysql 未装。跑 pip install pymysql 或 npx @hupan56/wlkj install-env')
+        return
+    _run_server_inproc(server)
+
+
+ZENTAO_URL_DEFAULT = 'http://10.89.2.91/zentao'
+
+
+def launch_zentao(repo):
+    """启动禅道 MCP。
+
+    凭据架构 (v3.1.4): 禅道是【每人一个账号】, 不是团队共享。
+      - URL (服务地址): 从 config.yaml 读 (团队共享, 这个确实是共享的)
+      - user/password (个人凭据): 从 .private/secrets/zentao.env 读 (gitignore, 私有)
+        —— 与蓝湖 cookie 同一套成熟模式 (get_secrets_dir 按开发者隔离)。
+      - 账号名映射 zentao_account: 从 member.json 读 (进 git, 非密钥, 团队需要知道来过滤归属)。
+    """
+    server = repo / '.qoder' / 'scripts' / 'protocol' / 'mcp' / 'zentao_mcp_server.py'
+    if not server.is_file():
+        _log(f'zentao server 不存在: {server}')
+        _launch_disabled_mcp('qoder-zentao', 'zentao_mcp_server.py 缺失')
+        return
+
+    # ① URL: 团队共享服务地址, 从 config.yaml 读
+    zentao_url = ZENTAO_URL_DEFAULT
+    cfg_path = repo / '.qoder' / 'config.yaml'
+    if cfg_path.is_file():
+        try:
+            import yaml
+            d = yaml.safe_load(cfg_path.read_text(encoding='utf-8')) or {}
+            zt = d.get('zentao', {}) or {}
+            if zt.get('url'):
+                zentao_url = str(zt['url'])
+        except Exception:
+            pass
+    os.environ['ZENTAO_URL'] = zentao_url
+
+    # ② user/password: 个人凭据, 从当前开发者的 .private/secrets/zentao.env 读
+    dev = _read_current_developer(repo)
+    zt_user = zt_pwd = ''
+    if dev:
+        try:
+            from foundation.core.paths import get_secrets_dir
+            env_file = Path(get_secrets_dir(dev)) / 'zentao.env'
+            if env_file.is_file():
+                for line in env_file.read_text(encoding='utf-8').splitlines():
+                    line = line.strip()
+                    if line.startswith('ZENTAO_USER='):
+                        zt_user = line.split('=', 1)[1].strip().strip('"\'')
+                    elif line.startswith('ZENTAO_PASSWORD='):
+                        zt_pwd = line.split('=', 1)[1].strip().strip('"\'')
+        except Exception:
+            pass
+
+    if not zt_user or not zt_pwd:
+        # 个人凭据未配 → 降级 disabled MCP, 提示配置路径
+        hint = ('workspace/members/%s/.private/secrets/zentao.env' % (dev or '<developer>'))
+        _log(f'禅道个人凭据未配置 (每人一个账号, 不再从 config.yaml 读)')
+        _log(f'  编辑 {hint}, 填 ZENTAO_USER=<你的禅道账号> 和 ZENTAO_PASSWORD=<你的密码>')
+        _launch_disabled_mcp('qoder-zentao', '禅道凭据未配置: %s' % hint)
+        return
+
+    os.environ['ZENTAO_USER'] = zt_user
+    os.environ['ZENTAO_PASSWORD'] = zt_pwd
+    _log(f'zentao 凭据已注入 (来自 {dev} 的 .private/secrets/zentao.env)')
+
+    # ③ 账号名映射: 从 member.json 读 (用于归属过滤, 进 git 非密钥)
+    if dev:
+        try:
+            from foundation.identity.identity import get_member
+            mem = get_member(dev)
+            acc = (mem.get('zentao_account') or '').strip() if mem else ''
+            if acc:
+                os.environ['ZENTAO_MY_ACCOUNT'] = acc
+                _log(f'zentao 归属账号: {acc} (来自 {dev} 的 member.json)')
+        except Exception:
+            pass
+    _log(f'启动 zentao (in-proc)')
+    # 校验 requests (本进程 import)
+    try:
+        import requests  # noqa: F401
+    except ImportError:
+        _log('⚠️ 当前 Python 无 requests! pip install requests')
+        _launch_disabled_mcp('qoder-zentao', 'requests 未装。pip install requests')
+        return
+    _run_server_inproc(server)
+
+
+def launch_lanhu(repo):
+    """启动蓝湖 MCP。用 venv 的 3.10+ python (fastmcp 要求), 读角色 cookie。
+    没装 lanhu venv 或没配 cookie 时, 输出友好提示并启动一个空壳 MCP
+    (让 QoderWork 显示"未启用"而不是黄/报错)。"""
+    venv = repo / 'external' / 'lanhu-mcp' / '.venv'
+    server = repo / 'external' / 'lanhu-mcp' / 'lanhu_mcp_server.py'
+
+    # 检查 venv
+    if not venv.is_dir():
+        _log('lanhu venv 未安装 — MCP 将以"未启用"模式启动')
+        _launch_disabled_mcp('lanhu',
+            '蓝湖 MCP 未安装。跑 python .qoder/scripts/setup_lanhu.py 安装')
+        return
+    py = _venv_python(venv)
+    if not py.is_file():
+        _log(f'lanhu venv python 不存在: {py}')
+        _launch_disabled_mcp('lanhu', '蓝湖 MCP venv 异常, 重装: setup_lanhu.py')
+        return
+    if not server.is_file():
+        _log(f'lanhu server 不存在: {server}')
+        _launch_disabled_mcp('lanhu', '蓝湖 MCP server 文件缺失')
+        return
+
+    # 读角色 cookie
+    dev = _read_current_developer(repo)
+    if not dev:
+        _log('未初始化开发者 (.qoder/.developer), 跑 /wl-init')
+        _launch_disabled_mcp('lanhu', '未初始化开发者, 跑 /wl-init')
+        return
+    cookie = _read_lanhu_cookie(repo, dev)
+    if not cookie:
+        _log(f'角色 {dev} 的蓝湖 cookie 未配置 (占位/缺失)')
+        _log(f'  编辑 workspace/members/{dev}/.private/secrets/lanhu.env')
+        _launch_disabled_mcp('lanhu',
+            f'蓝湖 cookie 未配置: workspace/members/{dev}/.private/secrets/lanhu.env')
+        return
+
+    # 注入 env (角色隔离: cookie + 用户名都是当前角色的)
+    env = dict(os.environ)
+    env['LANHU_COOKIE'] = cookie
+    env['MCP_TRANSPORT'] = 'stdio'
+    env['LANHU_USER_NAME'] = dev or 'Developer'
+    env['LANHU_USER_ROLE'] = 'Developer'
+    _log(f'启动 lanhu (角色={dev}, python={py}, 中继模式)')
+    # ⚠️ 不用 os.execv! Node.js spawn 下 os.execv 丢 stdin (Windows 的 execv 是新进程,
+    #    A 进程 stdin buffer 里的 initialize 字节传不到 venv 子进程 → 立即 EOF 退出)。
+    #    lanhu 必须用独立 venv (fastmcp 要 3.10+), 没法像 kg/mysql/zentao 那样 in-proc,
+    #    所以用 subprocess + 管道双向转发: launcher 当 stdio 中继, 子进程跑真实 server。
+    _relay_subprocess([str(py), str(server)], env)
+
+
+def _relay_subprocess(cmd, env):
+    """spawn 子进程并双向转发 stdio (替代 os.execv, 规避 Node-spawn 丢 stdin)。
+
+    用于 lanhu (需独立 venv, 无法 in-proc)。launcher 进程:
+      - 把自己的 stdin (QoderWork 发来的 JSON-RPC) 转发给子进程 stdin
+      - 把子进程 stdout (JSON-RPC 响应) 转发给自己的 stdout (回 QoderWork)
+      - stderr 各自独立 (诊断日志)
+    子进程退出 → launcher 退出 (QoderWork 管生死)。
+    """
+    import subprocess
+    import threading
+    child = subprocess.Popen(
+        cmd, stdin=subprocess.PIPE, stdout=subprocess.PIPE,
+        stderr=sys.stderr, env=env)
+    _log('lanhu 子进程已起 (pid=%s), 转发 stdio' % child.pid)
+
+    def pump_in():
+        """QoderWork stdin → 子进程 stdin (按行转发)。
+
+        ⚠️ 不能用 read(4096)! MCP 客户端发的一行 JSON-RPC 只有 ~150 字节,
+        read(4096) 会阻塞等满 4096 字节 → 永远不把单行转发出去 → 子进程收不到
+        initialize → 不响应 → 握手超时。必须用 readline() 按行转发 (MCP stdio
+        协议每条消息一行)。
+        """
+        try:
+            while True:
+                line = sys.stdin.buffer.readline()
+                if not line:
+                    break
+                child.stdin.write(line)
+                child.stdin.flush()
+        except (BrokenPipeError, OSError, ValueError):
+            pass
+        finally:
+            try:
+                child.stdin.close()
+            except Exception:
+                pass
+
+    def pump_out():
+        """子进程 stdout → QoderWork stdout (块读 + 按行过滤, 只放行 JSON-RPC)。
+
+        fastmcp 启动会往 stderr 打 ASCII banner (不污染 stdout), 但保险起见
+        仍过滤 stdout: 块读 4096, 按换行切行, 只转发能 JSON parse 的行。
+        """
+        import json as _json
+        buf = ''
+        try:
+            while True:
+                chunk = child.stdout.read(1)
+                if not chunk:
+                    # flush 残留 buf
+                    if buf.strip().startswith('{'):
+                        try:
+                            _json.loads(buf.strip())
+                            sys.stdout.buffer.write((buf.strip() + '\n').encode('utf-8'))
+                            sys.stdout.buffer.flush()
+                        except Exception:
+                            pass
+                    break
+                try:
+                    buf += chunk.decode('utf-8', errors='replace')
+                except Exception:
+                    continue
+                # 按换行处理完整行
+                while '\n' in buf:
+                    line, buf = buf.split('\n', 1)
+                    text = line.strip()
+                    if not text:
+                        continue
+                    if not text.startswith('{'):
+                        try:
+                            sys.stderr.write('[lanhu-stdout-noise] ' + line + '\n')
+                        except Exception:
+                            pass
+                        continue
+                    try:
+                        _json.loads(text)
+                    except _json.JSONDecodeError:
+                        try:
+                            sys.stderr.write('[lanhu-stdout-noise] ' + line + '\n')
+                        except Exception:
+                            pass
+                        continue
+                    try:
+                        sys.stdout.buffer.write((text + '\n').encode('utf-8'))
+                        sys.stdout.buffer.flush()
+                    except (BrokenPipeError, OSError, ValueError):
+                        return
+        except (BrokenPipeError, OSError, ValueError):
+            pass
+
+    t1 = threading.Thread(target=pump_in, daemon=True)
+    t2 = threading.Thread(target=pump_out, daemon=True)
+    t1.start()
+    t2.start()
+    child.wait()  # 子进程退出前不返回
+    _log('lanhu 子进程退出 (code=%s)' % child.returncode)
+
+
+LAUNCHERS = {
+    'kg': launch_kg,
+    'knowledge-graph': launch_kg,
+    'mysql': launch_mysql,
+    'zentao': launch_zentao,
+    'lanhu': launch_lanhu,
+}
+
+
+def main():
+    # ⚠️ 关键: 任何失败都走 _launch_disabled_mcp(), 绝不 sys.exit()。
+    # sys.exit(1) 会让进程退出 → QoderWork 显示黄色(连接错误), 用户以为坏了。
+    # _launch_disabled_mcp() 启动一个干净 stdio 循环响应 initialize →
+    # QoderWork 显示绿色(已连接, 0工具), 用户知道是"未启用"而非"坏了"。
+    if len(sys.argv) < 2:
+        _log('用法: mcp_launcher.py <kg|mysql|zentao|lanhu>')
+        _log(f'  argv={sys.argv}')
+        _launch_disabled_mcp('qoder-mcp',
+            '启动参数缺失: mcp_launcher.py <kg|mysql|zentao|lanhu>')
+        return
+    name = sys.argv[1].lower()
+
+    repo = find_repo_root()
+    if not repo:
+        _log('无法定位 QODER 仓库根。')
+        _log('  方式1: 设环境变量 QODER_REPO=<仓库根>')
+        _log('  方式2: 重跑 npx @hupan56/wlkj update (刷新 .repo-root)')
+        _log('  方式3: 在仓库目录内运行')
+        _launch_disabled_mcp(name,
+            '未定位到 QODER 仓库根。跑 npx @hupan56/wlkj update')
+        return
+    _log(f'仓库根: {repo}')
+
+    fn = LAUNCHERS.get(name)
+    if not fn:
+        _log(f'未知 MCP 名: {name} (支持: {list(LAUNCHERS)})')
+        _launch_disabled_mcp(name,
+            '未知 MCP 名: %s (支持: %s)' % (name, ', '.join(LAUNCHERS)))
+        return
+    try:
+        fn(repo)
+    except Exception as e:
+        # 启动函数抛异常也不能让进程死 (死=黄, 捕获=绿)
+        _log(f'启动 {name} 时异常: {e}')
+        _launch_disabled_mcp(name,
+            '%s MCP 启动异常: %s。跑 npx @hupan56/wlkj update' % (name, e))
+
+
+if __name__ == '__main__':
+    main()