前言¶
在 DeepSeek Harness（DSH）里接入 Model Context Protocol（MCP）服务器，常见做法是改 profile 配置、手写启动命令，或在多个客户端之间各自维护一份 mcpServers。条目多了之后，很难一眼看清谁在线、谁被关掉，从官方目录或别的编辑器里迁配置也要反复对照字段。
dsh-mcp-console 是维护者 CoderKuo 发布的工作流类 DSH 插件：在桌面应用侧栏增加「MCP」入口，对当前 profile 下的 MCP 做列表、启停、编辑、导出，并支持从官方 MCP 目录搜索、手动添加、AI 协助安装，以及扫描本机与其他客户端里已有的 MCP。新增配置通过 DSH 官方插件管理器的 install_bundle 完成，插件本身不直接向 profile 插入 MCP 条目。
这是什么¶
插件包名 dsh-mcp-console（npm 描述：Manage the MCP servers of a DeepSeek Harness profile）。它在 DSH Web 客户端注入侧栏与工作区 UI，读写仍走 DSH 官方的插件管理与 mcp-bundles 机制。适合已经在用 DSH、且需要长期维护多套 MCP 的开发者。
核心功能¶
下面按 README 中已说明的能力归纳，状态判断基于 DSH MCP 客户端可观察到的信息（@deepseek-ai/dsh-mcp-client 不对外暴露连接状态 API）。
MCP 列表与状态¶
侧栏「MCP」→「已安装」列出当前 profile 配置的全部服务器：名称、连接状态、传输方式、启动命令或地址、环境变量名、提供的工具、开源地址。状态分为：已连接（已注册 mcp__<名称>__* 工具）、连接中、失败（仅当配置了 failOnStartupError: true）、已禁用。连上、断开或启停时页面自动刷新，不依赖定时轮询。
启用、禁用与删除¶
每个服务器有开关，调用官方插件管理器的 setPluginEnabled，在 profile 的 cordis.patch.yml 写入 disabled 并立即生效，无需重启 DSH。AI 安装或导入的服务器可删除：卸载对应插件包，并清理其在 <DSH_HOME>/mcp-bundles 内的配置文件（目录外文件不改动）。
添加 MCP 的四种来源¶
「添加」标签先选来源，再在下方完成：
- 搜索 MCP 目录：在 registry.modelcontextprotocol.io（可在设置里改
registryUrl）按名称搜索，选中后把命令、环境变量、请求头填入手动添加表单。 - 手动添加：已知启动方式时直接填写本地命令（如
npx -y包名、uvx、docker run）或远程 streamable-http 端点；添加前在本机测试 MCP 握手；密钥可只配置「读取哪个环境变量」，配置里用!!js process.env.变量名，页面不展示明文。 - AI 快捷添加：填写仓库、npm/PyPI 包、Docker 镜像、目录页或任意链接及补充说明；插件在默认工作区新开创作模式会话（agent 预设
cordis，带plugin_manager），由 AI 按官方推荐流程阅读文档、试运行、写 bundle 并install_bundle，每一步安装需你批准。 - 一键导入：从 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex 等客户端扫描到的 MCP 直接导入，不经过 AI。
仅支持 SSE 或需 OAuth 的远程服务，可通过「mcp-remote」桥接（npx -y mcp-remote <地址>）。
编辑与导出¶
mcp-bundles 下仅含单个 MCP 的配置包可表单编辑；保存前测试，失败会恢复原配置。列表右上角可导出标准 mcpServers JSON（不含密钥，占位为 ${变量名}）。
发现本机可接入的服务¶
「发现」里点「扫描本机」：在本机读取已装应用、后台服务、监听端口、Docker 容器及其他客户端 MCP 配置（清单不含文件路径）。确认后可选「交给 AI 联网分析」，由当前会话模型检索哪些软件提供 MCP，再按同样流程接入。
安全与日志¶
页面只显示环境变量和请求头的名称，敏感值打码。操作与错误写入 <DSH_HOME>/storages/dsh-mcp-console/logs/（单文件 1MB、保留约 7 天且总量约 5MB 内）。「诊断信息」可复制插件与 DSH 版本、各服务器状态，便于排错。
安装与启用¶
在 DSH 桌面应用的插件页点添加插件，安装源选官方源，填入：
dsh-mcp-console
安装后侧栏出现「MCP」入口。README 说明：新版本发布后 24 小时内按包名安装可能被包管理器拒绝，可改用 GitHub Release 安装包地址：
https://github.com/CoderKuo/dsh-mcp-console/releases/latest/download/dsh-mcp-console.tgz
插件以 MIT 许可证发布；package.json 当前版本为 0.1.11。GitHub 仓库约 3 stars（以目录页/仓库页面为准）。
典型用法¶
从官方目录快速接入¶
- 打开侧栏「MCP」→「添加」→ 选择搜索官方目录。
- 输入名称，在结果里点「填入」到手动添加表单。
- 按需改环境变量（密钥行勾选「读环境变量」并在系统里设置变量后，需完全退出并重新打开 DSH）。
- 点「添加」先测试连接，成功后再安装到
mcp-bundles。
用 AI 从仓库安装¶
- 「添加」→ 让 AI 安装，来源填
https://github.com/owner/project或owner/project。 - 点「开始安装」，切换到默认工作区新会话；可按模型选择器指定本次供应商和模型（不改默认模型）。
- 在会话中逐步批准安装；完成后在「已安装」里确认工具列表与状态点。
从 Cursor 等客户端导入¶
- 「发现」→「扫描本机」，展开其他客户端分组。
- 对目标 MCP 使用一键导入，或跳到「添加」里的导入流程。
- 在「已安装」用开关启停，需要迁移时用「导出」生成 JSON 给其他客户端。
可选配置¶
在 profile 的 cordis.patch.yml 中，行 id 为 mcp-console 时可调整例如：agentPreset（默认 cordis）、bundleDirectory、scanTimeoutMs（默认 20000）、registryUrl、repositories 等，详见仓库 README 设置表。
适用场景与注意¶
适合：在 DSH 里维护较多 MCP、需要统一看状态与启停、希望从官方目录或其他 AI 客户端迁配置、或想在本机扫描后再让 AI 查哪些服务有 MCP 的开发者。
注意：
- 插件与 DSH 以当前进程权限运行；AI 安装或扫描会执行本机命令（经
ctx.subprocess，带超时与清洗过的环境变量）。安装前请自行查看目标 MCP 源码与许可证。 - 手动添加的命令不经过 shell，管道与重定向无效；
npx、uvx、docker等需在 DSH 的 PATH 中可用。 - 不能在此界面单独切换的条目，开关会说明原因（例如由别的配置层定义或由整包插件承载）。
- 社区插件目录 SkillHub 上的条目 与 GitHub 仓库为公开信息来源，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-mcp-console 把「列出来、开关掉、加进去、导出去」收进 DSH 侧栏，并区分目录搜索、手动测试添加、AI 安装与本机发现四条路径，同时尽量不把密钥写进配置或日志。若要查看详情、问题反馈或本地开发（pnpm install / pnpm run check），见 GitHub：CoderKuo/dsh-mcp-console 与 SkillHub 目录页。
