dsh-mcp-manager-ui

中文 | English

<a href="https://linux.do/" title="LINUX DO"><img src="docs/images/linux-do-logo.svg" alt="LINUX DO" width="40" height="40"></a>

DeepSeek Harness Web 的 MCP 管理面板：右下角悬浮按钮或侧栏「MCP」入口，点开就能看连接状态、加服务器、改配置——面板浮在会话之上，不打断正在进行的对话。

界面预览

全局管理面板

项目作用域（.dsh/mcp.json）

连接详情与新增

功能

• 查看每个 MCP 的状态、传输方式、连接参数与工具列表；展开工具可看完整输入 JSON Schema（必填/可选、类型、枚举、默认值与原始 JSON）
• 按传输方式（HTTP/stdio）与状态筛选，按名称/命令/URL 搜索
• 启用、禁用、重连、添加、编辑、移除；需要时用眼睛临时揭示被掩码的凭据并一键复制
• 全局 + 项目双作用域：全局写 Web profile，一次注册所有项目可用；项目写该项目 .dsh/mcp.json，只该项目会话可见；项目里还能「屏蔽」某个全局 MCP
• 两个入口，同一个面板：右下角悬浮按钮（可拖拽、记忆位置）与官方侧栏入口（展开态在「设置」上方显示「MCP」，收起成 56px 轨道时只剩图标）共享同一开关状态；面板右上角「入口」可以把两者只留一个（不能都关）
• 从「内置 MCP」目录一键安装 Exa、Tavily、Firecrawl、Chrome DevTools、Playwright（已配置的只识别并跳过，不覆盖）
• 导入本机其他客户端的 MCP 配置：自动检测 Claude Code、Codex（config.toml）、OpenCode（含 .jsonc）、pi、Claude Desktop、Cursor、Windsurf、VS Code、Gemini CLI、Roo Code 与跨工具的共享配置，逐个列出，点一条即导入；也能粘贴 Claude/Cursor/Cline/Roo 的 mcpServers 或 VS Code 的 servers JSON。写入前预览，支持「合并（同名更新）」与「替换」
• 跟随 DSH 深色/浅色主题，适配窄屏与移动宽度
• 非强制更新提示：有新版时在面板顶部显示可关闭的提示条，每天最多查一次、绝不自动更新，可用 DSH_MCP_MANAGER_DISABLE_UPDATE_CHECK 关闭
• 升级后主动说一次变了什么：版本变了后第一次打开面板弹一张小卡片，列出本次更新内容，并指路新功能在哪（例如「入口」开关在面板右上角）；确认一次后不再提示，不联网、不发任何数据

安装

# 推荐：npm 安装 —— 之后 `dsh plugin update` 会在 ^1.x 内自动升到最新小版本
dsh plugin --profile web add dsh-mcp-manager-ui@^1.4.0

# 或固定 GitHub release tag（不会自动跨版本，升级要换 tag 重新 add）
dsh plugin --profile web add github:Imzl-zl/dsh-mcp-manager-ui#v1.4.0

装完重启 dsh web。升级：

dsh plugin --profile web update dsh-mcp-manager-ui

卸载（不会删除 profile 里已有的 MCP 条目）：

dsh plugin --profile web remove dsh-mcp-manager-ui

细节、本地开发安装与故障排查见 安装与升级。

不要把 mcp-manager-ui 手工插进 profile 的 cordis.patch.yml、Agent preset 或额外的 --patch 文件——插件命令已经完成这件事，重复装配会明确报错。

使用

打开面板

两个入口，同一个面板：

• 右下角悬浮按钮：可拖拽移动，位置会被记住；
• 侧栏底部「MCP」：展开态在「设置」上方，侧栏收起成 56px 轨道时只剩图标。

面板浮在会话之上，关掉它（右上角「关闭」或 Esc）不会影响会话。

两个入口都能单独关掉：面板右上角「入口」里选 悬浮按钮 + 侧栏入口（默认）/ 仅悬浮按钮 / 仅侧栏入口。不能两个都关——面板只能从这两个入口打开，所以这是一个三选一，而不是两个独立的开关。选择存在浏览器本地（localStorage），换浏览器或清缓存要重选一次。

全局 vs 项目

顶部标签页在「全局」与各项目之间切换：

标签页	存哪	谁可见	改动何时生效
全局	Web profile 的 cordis.patch.yml	所有项目	DSH 热加载，通常立即生效
某项目	该项目 .dsh/mcp.json	只该项目会话	下一次新建的连接（见下）

serverName 按作用域判重：不同项目之间、全局与项目之间可以同名，各自独立连接；同一作用域内不能重名。

常用操作

在列表行或详情页里：

• 开关：启用 / 禁用（全局写 profile 补丁的 disabled，项目写 .dsh/mcp.json）；
• 重连：仅全局可用（项目连接由会话持有，重连由 mcp-client 自己管）；
• 编辑 / 移除：移除只影响当前作用域；
• 屏蔽（项目页里对全局 MCP）：写 exclude，该项目的新会话不再看到它——全局实例仍在跑，所以不影响其他项目。

添加 MCP

三条路，都从面板顶部工具栏进：

1. 添加 MCP：表单填 command/args/env/cwd（stdio）或 url/headers（HTTP），可设调用超时、启动失败策略与重连策略；常用服务器有预设模板可一键套用。
2. 导入 JSON：粘贴其他客户端的配置，先预览再写入。支持「合并（同名更新）」与「替换」，字段映射与限制见 JSON 导入。
3. 内置 MCP：勾选未配置的项一次装好（Exa、Tavily、Firecrawl、Chrome DevTools、Playwright）。前三项有免密额度、不需要本地依赖；后两项是本地工具，需要 Node.js 与浏览器。已配置的项只识别并跳过，不会覆盖。

看工具与敏感值

详情页列出该 MCP 当前注册的工具；展开可看完整输入 Schema。凭据类字段默认掩码，点眼睛图标会向 Host 读取有效运行值（已解析过的环境变量）并临时显示，再点一次恢复；已显示的值可一键复制。编辑时若没实际改动输入，保存仍保留原来的引用写法，不会把密钥写回配置文件。

配置生效时机（重要）

作用域	修改后何时生效
全局	DSH 热加载，通常立即生效（含运行中的会话）
项目	下一次新建的连接生效；正在运行的会话不受影响

项目 MCP 在会话创建/恢复时按当时的 .dsh/mcp.json 装配，会话进行中不重读配置——会话里改配置不生效是预期行为（Claude Code、Codex 等客户端的项目级 MCP 同样要求新开会话）；「屏蔽」同理，只对之后的会话生效。改完不需要点「重连」，也不需要重启 Host。

…