dsh-tui-mcp-manager

面向 dsh-TUI 的原生 MCP Server 管理插件。输入 /mcp-manager 后，管理器通过宿主提供的 managed dialog 显示为聊天界面上的浮窗，并直接编辑当前 profile 的 cordis.patch.yml。

功能

浮窗内查看服务器状态、初次连接后的工具数与错误。
添加、编辑、启停、重连和删除 MCP server。
完整配置 stdio 与 streamable-http transport。
编辑参数、工作目录、环境变量、请求头、超时、启动失败策略与自动重连参数。
敏感环境变量和请求头通过任意 DSH credential reference 保存，不写死 credential 名称。
字段编辑时按 Esc 回到表单总览并保留草稿；总览中的 Cancel 才放弃表单。
跟随 dsh-TUI 的 /lang zh 与 /lang en 语言选择。
UI 文案只使用 ASCII 状态标签，不依赖 emoji 字宽。

安装

要求 Node.js ^22.19 || >=24 与 dsh-TUI 0.9.x；当前验证基线是 dsh-TUI 0.9.2。

pnpm install
pnpm check
dsh plugin --profile dsh-tui add .
dsh --profile dsh-tui

进入 TUI 后输入：

/mcp-manager

语言由 dsh-TUI 统一管理：

/lang zh
/lang en

文件原生化

cordis.patch.yml 是唯一事实源：

dsh-TUI managed dialog
    -> atomic update of a managed block
$DSH_HOME/profiles/dsh-tui/cordis.patch.yml
    -> DSH patch watcher
Cordis Loader / HMR
    -> @deepseek-ai/dsh-mcp-client

插件只修改下面的兼容 marker block，marker 外的 patch、注释和 !!js 表达式保持原样：

# >>> dsh-mcp-manager: managed MCP server rows >>>
- insert:
    - id: mcp-manager--filesystem
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        transport: stdio
        serverName: filesystem
        command: npx
        args: ['-y', '@modelcontextprotocol/server-filesystem', /workspace]
        env: {}
        cwd: ''
      x-dsh-mcp-manager:
        id: filesystem
        name: Filesystem
#

MY_CONTEXT7_KEY 只是示例引用名，可以换成任何有效的 POSIX 标识符。profile patch 中只会出现：

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

当前 dsh-TUI input dialog 是单行明文输入，插件会提示凭据输入过程可见；保存后的服务器总览、 profile patch 和 RPC snapshot 都不会显示真实值。

dsh-TUI 扩展契约

本包按当前社区约定提供：

独立仓库、MIT、纯 ESM、语义化版本与 Node engine 约束。
根入口只导出 Cordis name、Config、apply，不提供 default export。
相对导入使用 .js，TypeScript 生成 JS、source map 与 declaration。
dsh-plugin.json 声明 Command contract、commands.invoke 权限与 Host facet。
通过 ctx.get('tuiPluginHost', false) 使用 mediated command registration。
tuiDialogs、tuiCommandTrees 和 tuiPluginHost 都按可选能力探测；缺失时静默降级，不能阻止 TUI 启动。
每个注册和子 fiber 都绑定 Cordis 生命周期并在卸载时清理。

dsh-TUI 0.9.2 已提供 mediated command API，但普通 Cordis Loader row 尚不一定自动绑定 Component identity。只有宿主明确返回 COMPONENT_NOT_ADMITTED 时，本包才退化到旧的 commands.register；权限拒绝、manifest 不兼容或其他 admission 错误不会被 fallback 绕过。

当前包名保留为无 scope 的 dsh-tui-mcp-manager，便于先推到个人远端。若后续被生态组织收录，再将 npm 包名和 Cordis row 一并迁移为约定的 @dsh-tui-ecosystem/；不要在没有组织发布权限时预占该 scope。lib/types/ 构建产物按模板约定纳入版本库，Git URL 安装不依赖发布者机器上已有的构建目录。

社区 manifest v0.15 目前仍是 experimental draft，本 README 只声明兼容该草案，不声称得到官方认证。插件在宿主进程内运行，manifest permissions 是审计和宿主策略提示，不是操作系统安全沙箱；安装等同于信任本包拥有当前用户对 profile patch 与 credentials provider 的权限。

构建与发布检查

pnpm typecheck
pnpm build
pnpm verify
npm pack --dry-run

构建产物：

lib/types/index.js         Cordis 根入口
lib/types/plugin.js        文件管理服务与 TUI 接入
lib/types/server/index.js  credential-aware 单服务器适配器
lib/types/tui/index.js     managed dialog 与 /mcp-manager 命令

目录结构：

dsh-plugin.json         社区 v0.15 experimental manifest
cordis.patch.yml        单一 Cordis Loader row
src/index.ts            精简的 Cordis 公共契约
src/plugin.ts           运行时组合与生命周期入口
src/host/               patch store、状态投影和配置 schema
src/server/             credential-aware MCP client 适配器
src/tui/                dsh-TUI 浮窗和表单
scripts/verify.mjs      manifest 与 Cordis 入口契约检查

安装

说明文档

dsh-tui-mcp-manager

功能

安装

文件原生化

dsh-TUI 扩展契约

构建与发布检查