dsh-mcp-global-manager
MCP 全局管理：扫描已知工具的 MCP 配置（28 个内置源与自定义源），一键刷新同步差异，双向导入/写回，并在 DSH 侧栏直接增删改 MCP 服务器。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:asfre/dsh-mcp-global-manager#511d071c999b2d03f446345f56d9a5c5568b6122
Mcp Global Manager 以 dsh-mcp-global-manager 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 侧栏面板：把散落在本机各编程工具里的 MCP 配置收进一处——扫描差异 → 一键采纳进 DSH → 需要时写回原工具 → DSH 侧直接增删改停用。
A DSH sidebar panel that scans MCP configs from the tools it knows (28 built-in sources plus custom ones), syncs diffs into DSH, and lets you import, write back, or edit MCP servers.
MIT · Windows / macOS / Linux · DSH ≥ 0.1.6-alpha · 不出网 · 不执行命令
以下截图中的本机绝对路径已做模糊处理，仅保留
~/%APPDATA%通用占位。
① 扫描总览 —— 顶部状态徽章（条目 / 一致 / 存在的文件）+ 按工具分组的差异账本，新/变/缺/同四态一目了然：
② DSH 侧新增 —— 三步表单（基本信息 / 怎么启动 / 环境变量），支持整行命令粘贴「识别」自动拆好，底部实时预览将要写入的内容：
③ 来源注册表 —— 28 个内置源 + 自定义源，每条带 builtin 徽章与多平台候选路径，可点开展开管理、增删自定义源：
④ 自检横幅 —— 面板内「自检」一键校验 js-yaml 解析、安装包/bundles/client.js 是否就位、DSH 受管行数：
MCP 配置散在 Claude Code / Codex / VS Code / Cursor / Trae / Kiro / OpenCode / Cline / Gemini CLI 等 28 个已登记源（外加自定义源）的配置文件里，同名条目（比如 pencil 出现在 5 个工具里）改一处忘三处。这个插件做三件事：
// 注释与尾随逗号都能吃）。cordis.patch.yml，生成 @deepseek-ai/dsh-mcp-client 受管行（与 dsh-mcp-manager-plus 的行形状互通，彼此认得对方的行）。侧栏入口：地球图标 + MCP全局管理（order: 22，排在 dsh-remote-web-ui「远程链接」的 21 后面；没装那个插件也照常可用）。
无变化 / 新发现 / 有变化 / 源里已删 四态指纹；JSON 键序重排不误报；同名条目跨工具互相点名（重复于: Trae CN, Cursor）。--emit 预览与真实导入共用同一个纯函数，「说写几行」＝「真写几行」。KEY/PASSWORD/SECRET/TOKEN/AUTH/BEARER/COOKIE/CRED 任一（不分大小写）的 env 键与请求头，以及 URL 查询串里的同名令牌，面板一律打码显示；写回时服务端用磁盘原值逐条还原，还原不了（源文件里压根没有这条真值）直接 409 拒写——任何配置文件都不会被写进那八个圆点。~/.dsh/mcp-global-manager/backups/，最多保留 40 份。用 DSH 自带的插件命令，--profile 换成你实际在用的 profile 名（web / desktop / tui …）：
# ① 包发布到 npm 之后（推荐）
dsh plugin --profile web add dsh-mcp-global-manager
# ② 从源码装（开发态，无需 npm 账号）
dsh plugin --profile web add file:C:/Users/you/dsh-plugins/dsh-mcp-global-manager
# ③ 或装 GitHub Release 上的 tarball
dsh plugin --profile web add https://github.com/asfre/dsh-mcp-global-manager/releases/latest/download/dsh-mcp-global-manager.tgz
装完彻底重启 DSH（托盘右键退出再打开——Ctrl+R 只重载前端，宿主进程里的 lib/*.js 还是旧的），侧栏「远程链接」正下方就会出现 MCP全局管理。
~/.dsh/mcp-global-manager/state.json 下次扫描全新开始。[A-Za-z0-9_-] 字符（API 文档 → API，纯中文 → server-<hash6>），面板会提示改名。它会做什么：
cordis.patch.yml（先校验后备份再原子写）；② 你在某条上开过「允许写回」并确认，才写那个工具自己的配置文件。~/.dsh/mcp-global-manager/（state.json 差异账本 + backups/ 写前备份），在插件目录之外，也不随仓库分发。它不会做什么：
/mcp-global/* 通信。不上传、不上报你的配置。npx / git / 下载脚本，只改配置文本。state.json 会为每条扫到的条目保留上次的原值快照（含 env 里的 token 明文），用于「消失条目回补展示」和写回还原——它只落你本机磁盘、绝不出网。如果这台机器有多用户或远程控制软件，注意 ~/.dsh/mcp-global-manager/ 的目录权限。127.x.x.x / localhost / [::1]（挡 DNS 重绑定）。同站的 CSRF 一律 403。同时要说清：loopback 端口对本机任意进程可见，跑不受信程序的机器上别指望这层隔离。本地脚本不带 Origin、桌面壳用自定义协议源，正常放行。⚠️ 提醒：不少工具（如 Trae CN 的 Apifox 条目）把 token 明文存在自己的配置里，本插件不改变这一点——别把那些文件原样贴给别人或提交进仓库。
写回完整性：任何写盘都走 读原文 → 纯函数改 → 结构校验 → 回读验证 → 备份 → 原子写，任一环节不过整笔取消，磁盘一个字节不动。
内置清单之外的新工具：面板「扫描的源」里加一条自定义源（id / 格式 / 容器键 / 候选路径，支持 %APPDATA% 等环境变量展开），标 允许写回 才会真写。
//、/* */ 注释与尾随逗号会丢失（读能容错，还原不了）；写前必有备份，丢了可回滚。[mcp_servers.x] 一层；.env / .http_headers 子表写回时展平成 env = { K = "V" }。id 命名空间全 profile 共享：停用/删除/改名三个操作都先确认补丁里存在这条受管服务器行，认不出主就 409/404 拒绝。服务名避开 manager-plus 一类与插件同名的前缀即可。@deepseek-ai/dsh 的 >=0.1.6-alpha.1 <0.2.0-0 或 >=0.2.0-rc.1 <0.3.0-0（0.2.0 正式版前的过渡版本不支持）。node tools/cli-scan.mjs # 只扫描打印；--emit 预览导入 YAML
node test/run.mjs # 后端单测（含写路径沙箱演练）
node tools/smoke-client.mjs # 面板渲染冒烟（React 桩，拦整页白屏）
node tools/cold-start-check.mjs # 冷启动演练：等价「重启后用户的第一次点击」
改源码后同步进 profile：powershell -ExecutionPolicy Bypass -File tools/sync-to-profile.ps1，然后按改动侧决定 Ctrl+R（仅客户端）或彻底重启（宿主 lib/*.js）。
⚠️ js-yaml 版本坑（社区装机最常见的「重启后崩」）：补丁方言依赖 js-yaml 4.x 的 Type 构造器，package.json 已显式声明 dependencies，但 profile 的 hoisted 目录可能被别的插件的 5.x 占位。resolveYaml() 会按能力挑副本（标准解析 → .pnpm/js-yaml@4.x → 邻居目录兜底）。装完务必重启后点一次 自检。
从 profile 移除这条依赖（dsh plugin remove 或删 dsh.profile.bundles 里的条目），刷新界面即可。DSH 补丁里已生成的 mcp-* 行不会跟着消失——那是你的配置，不是插件的东西；需要的话在面板里逐条删。账本与备份在 ~/.dsh/mcp-global-manager/，一并删除即彻底清理。
MIT