dsh-tui-mcp-manager

dsh-tui-mcp-manager

English | 中文

在 dsh-TUI 中集中管理 MCP 服务器、Set、工具与运行状态。 无需离开终端，输入 /mcp-manager 即可打开全屏界面。

安装

需要 Node.js ^22.19 || >=24、dsh 0.2.1-rc.2 和 dsh-TUI >=0.16.1 <0.17.0。

npm install -g @deepseek-harness-tui/dsh-tui@0.16.1
dsh plugin --profile dsh-tui add dsh-tui-mcp-manager
dsh-tui

进入 TUI 后运行 /mcp-manager。界面语言跟随 dsh-TUI，可用 /lang zh 或 /lang en 切换。

dsh-TUI 0.16.1 通过 Loader 接纳本插件，/mcp-manager 通过宿主托管注册，遵循插件归属与 commands.invoke 授权；接纳失败时不注册命令。界面语言支持新版 ~/.dsh-tui/settings.json。

请通过 dsh-tui（或 dst）启动，默认使用 dsh-tui profile，无需传 --profile。已验证 dsh 0.2.1-rc.2 + TUI 0.16.1 的正式启动器组合顺序、命令调用和卸载。旧的 dsh --profile dsh-tui 入口在 TUI 0.16.1 中可能因宿主接纳顺序导致命令未注册；本插件不会绕过接纳或授权检查。

dsh 升级命令：npm install -g @deepseek-ai/dsh@0.2.1-rc.2。TUI 0.16.1 已声明兼容该版本，可直接安装：

dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui@0.16.1

预览

核心能力

服务器编辑器支持 dsh 0.2 的 maxInstructionBytes，用于限制服务器说明进入系统提示词时的 UTF-8 字节数，默认 32768。MCP 资源由 dsh 的共享资源工具按需读取。

服务器、Set 和工具列表都支持 / 搜索。服务器概览还会显示它所属的全部 Set：◆ 表示活动，◇ 表示未活动。

Set 如何生效

实际运行的服务器是所有活动 Set 成员的并集。重复成员只会启动一次：

Set A: context7, websearch
Set B: websearch, ghgrep
运行:  context7, websearch, ghgrep

首次使用时会生成包含现有 MCP 的 Default Set；保存后它就是普通 Set。停止服务器只影响当前进程，不会改变 Set 成员关系；也可以随时原地恢复。

按键

配置与安全

• 服务器配置直接读写当前 profile 的 cordis.patch.yml，不维护第二份数据库。
• Set 保存在同目录的 mcp-manager.sets.yml，只记录 Set 信息和服务器 ID。
• 完整的读取、修改、写入过程与 dsh 的 Profile 配置编辑器共用锁，避免多个窗口或进程互相覆盖；managed block 外的内容保持不变。
• 服务器与 Set 联动修改一起提交，使用 fsync、原子 rename 和恢复日志。保存失败会回滚；进程中断后，下次访问会恢复未完成的提交。若检测到后续人工修改，则保留文件并提示冲突。
• 删除服务器时会同步清理所有 Set 引用。
• 敏感值只写入 credentials provider，配置文件中仅保留引用。
• 升级旧版 dsh 时，如果 profile 尚无 managed block，会从保留的 settings.yaml 或 settings.yaml.imported 一次性导入旧 MCP 配置。

# >>> dsh-mcp-manager: managed MCP server rows >>>
# managed MCP server rows
# <<< dsh-mcp-manager: managed MCP server rows <<<

secretHeaders:
  api-key:
    ref: MY_CONTEXT7_KEY
    prefix: ''

更新与卸载

重新执行安装命令即可更新。卸载使用：

dsh plugin --profile dsh-tui remove dsh-tui-mcp-manager

git clone https://github.com/0N3-0/dsh-tui-mcp-manager.git
cd dsh-tui-mcp-manager
pnpm install --frozen-lockfile
pnpm check
dsh plugin --profile dsh-tui add .

pnpm check
npm pack --dry-run
pnpm smoke:package

兼容性

当前构建与运行基线为 dsh-TUI 0.16.1 与 dsh 0.2.1-rc.2。项目采用纯 ESM 和 MIT 许可证；发布由 GitHub Actions OIDC Trusted Publishing 完成。

插件运行在宿主进程内。manifest 权限用于宿主审计与策略声明，不是操作系统安全沙箱。

License

MIT © 2026 0N3-0