前言¶

在 dsh-TUI 环境下管理 MCP 服务器、Sets、工具和运行状态，需要频繁切换终端窗口。下面介绍的 dsh-tui-mcp-manager 是一个原生插件，它为 dsh-TUI 提供了一个全屏管理界面。通过输入 /mcp-manager，可以在不离开 TUI 的前提下完成 MCP 的 CRUD、启停、Sets 编排以及凭据引用管理等操作。

核心功能¶

该插件通过 /mcp-manager 浮窗实现以下能力：
* 服务器池管理：支持创建、复制、编辑、停止、重连和全局删除服务器。
* MCP Sets 编排：可以对 Set 的成员进行编排，实现独立启停、设置启动时状态，并对跨 Set 的重复成员进行自动去重。
* 工具浏览：提供工具说明与输入 Schema 的浏览，支持按名称或说明搜索。
* 诊断检查：自动检查配置、连接、运行时和工具注册状态。
* 凭据管理：通过 DSH credentials 引用敏感环境变量与请求头，敏感值只写入凭据提供者，配置文件中仅保留引用。

安装与启用¶

在安装前，请确保环境满足以下要求：
* Node.js ^22.19 || >=24
* dsh 0.2.0-rc.1
* dsh-TUI >=0.11.2 <0.12.0

执行以下命令安装插件：

dsh plugin --profile dsh-tui add dsh-tui-mcp-manager

安装完成后，启动 dsh-TUI 并在 TUI 内输入 /mcp-manager 即可打开全屏界面。界面语言跟随 dsh-TUI，可通过 /lang zh 或 /lang en 切换。

配置与操作¶

插件通过注册 commands 服务来接纳 /mcp-manager 命令。在 dsh-TUI 0.11.2 版本中，该版本尚未向第三方 Loader 插件开放命令接纳流程，因此本插件通过该机制完成注册。

文件存储¶

服务器配置直接读写当前 profile 的 cordis.patch.yml，Set 信息保存在同目录的 mcp-manager.sets.yml。插件使用 fsync 和原子 rename 确保写入安全，managed block 外的内容保持不变。删除服务器时会同步清理所有 Set 引用。

界面操作¶

在 /mcp-manager 界面中，可以使用以下按键：
* Tab：切换焦点。
* w：切换 Set 与服务器池视图。
* Enter：打开、编辑或确认。
* /：在当前列表中搜索。

Set 生效逻辑¶

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

注意事项¶

• 诊断行为：诊断页未处于活动 Set 的服务器会临时启用已有 Loader 配置完成握手，读取状态后立即停止，不会修改 Set 或配置文件。
• 配置写入：敏感字段在配置文件中仅保留引用。升级旧版 dsh 时，如果 profile 尚无 managed block，会从保留的 settings.yaml 或 settings.yaml.imported 一次性导入旧 MCP 配置。
• 运行环境：插件以当前 dsh 进程权限运行，manifest 权限用于审计与策略声明，非操作系统安全沙箱。

结语¶

dsh-tui-mcp-manager 为 dsh-TUI 用户提供了集中化的 MCP 管理入口。通过原子写入配置文件和引用式凭据管理，它在保持 TUI 交互体验的同时，兼顾了配置的持久化与安全性。