dsh-plugin-mcp-toggles

dsh-plugin-mcp-toggles

为每个会话单独开关已安装的 MCP 服务器。

装好之后，会话标题栏右侧（新会话页则是输入卡片上方那一行）会出现一个 MCP 按钮，点开列出已安装的 MCP 服务器，每行一个开关，只影响当前会话。

安装

用 DSH 自带的插件命令，装进你要用的 profile：

dsh plugin --profile web add dsh-plugin-mcp-toggles

把 web 换成你的 profile 名（desktop、tui、headless 等）。这条命令会 把它加入该 profile 的依赖与 bundle 列表，然后重启 DSH 即可。

指定版本或改用 GitHub 源：

dsh plugin --profile web add dsh-plugin-mcp-toggles@0.1.0
dsh plugin --profile web add github:ZhaoHanshao/dsh-plugin-mcp-toggles

卸载：

dsh plugin --profile web remove dsh-plugin-mcp-toggles

在 DSH 会话里，也可以让 agent 用 plugin_manager action=install_bundle target=dsh-plugin-mcp-toggles 完成同样的安装。

用法

1. 打开任意会话 —— 或直接停在新会话页。
2. 点标题栏（新会话页则是输入卡片上方那一行）的 MCP 按钮。
3. 逐行开关，或点 全部开启 / 全部关闭。

按钮上的徽标显示当前状态：全部开启、n/m、全部关闭；部分关闭时按钮转为警示色。

开关立即生效，无需重启会话或重开服务器。

它解决什么

MCP 服务器在 DSH profile 里是进程级的：@deepseek-ai/dsh-mcp-client 每行连一个 服务器，把 mcp__<serverName>__<tool> 注册进全局工具层。于是每个会话都看到 同一批 MCP 工具 —— 想让 A 会话只用 REA、B 会话只用别的服务器，原生做不到。

本插件把这份「全局可见」变成「按会话可见」。新会话默认全部开启，所以装上它 不会悄悄改变任何人现有的能力；只有你亲手关掉的服务器才会在该会话里消失。

它怎么工作

agent.ctx.tools.restrict({ deny }) 是作用域内生效的全局工具掩码。可见性、 schema 投影与派发都走同一个解析器，因此被关掉的工具模型既看不到也调不到，其他 会话完全不受影响。

• 关闭某服务器 → 把它的 mcp__<server>__* 工具加进该会话的 deny 集。
• 全部服务器都关闭时，共享的 list_mcp_resources 等资源工具一并隐藏 （sharedResourceTools: false 可关掉这个联动）。
• 掩码按 deny 指纹幂等：工具集变化时只重算、不重复叠加。

两个入口，同一个开关集合

槽位	出现位置
conversation.session.header.utilities	已有会话的标题栏右侧
conversation.hero.options	新会话落地页，紧跟 workspace 与模式控件之后

两处必须都有：新会话页的会话页头带 hideChrome （blank && composerPhase === 'blank'），此时整个 header 都不渲染，只挂标题栏会让 按钮在新会话页上完全消失。两个槽都提供同一个 sessionId，所以在哪一处切换都是 同一个会话的开关 —— 在新会话页关掉的服务器，进入对话后依然关着。

开关存在哪

$DSH_HOME/mcp-toggles-state.json：

{ "bySession": { "<sessionId>": { "rea": false } } }

键是 sessionId。没有记录即视为开启 —— 只会记录「关掉」，所以新会话、以及删掉 状态文件之后的会话，都回到全部开启。

配置

在 profile 的 cordis.patch.yml 里覆盖 mcp-toggles 这一行的 config：

字段	默认	含义
sharedResourceTools	true	关闭全部 MCP 时是否连共享资源工具一起隐藏。
extraServers	[]	额外要认作 MCP 服务器的名字；用于服务器暂时没有注册任何工具时也能列出来。

兼容性

• DSH：需要 @deepseek-ai/dsh-client-ui-conversation ≥ 0.2.1-rc.3 （提供上述两个槽位与 webServer 服务）。这条写进了 peerDependencies 并标记为 可选 —— DSH 把这些包内置在安装目录里，普通 npm 安装不该再拉一份副本。
• Node：^22.19.0 || >=24.0.0，与 DSH 官方下限一致。

已知限制

• 只管理 MCP 工具（mcp__* 前缀与共享资源工具），不动其他工具。
• 服务器列表来自 configEditor.entries() 里的 @deepseek-ai/dsh-mcp-client 行； configEditor 不可用时退回当前工具名前缀，此时没有工具的服务器不会出现在列表里。
• 开关按会话 id 保存；会话被删除后对应记录会保留（无害，不会影响其他会话）。

开发

没有依赖、没有构建步骤，lib/ 就是发布内容。改完直接检查：

npm run prepublishOnly    # node --check 两个入口
npm pack --dry-run        # 查看将要发布的文件

License

MIT