前言¶
DeepSeek Harness(DSH)采用插件化架构,通过扩展配置文件来管理各类功能。Model Context Protocol(MCP)作为连接模型与外部工具的协议,其配置通常需要手动编辑 YAML 或 JSON 文件。修改配置文件容易出错,且缺乏可视化的启停控制。dsh-mcp-manager-plus 插件在 DSH 设置界面的左侧边栏新增了「MCP 管理」页面,解决了在浏览器端直接管理 MCP 服务器的问题。
这是什么¶
这是一个由 appthin 维护的 MCP 服务器管理插件。它主要解决在 DSH 环境下查看、启用/停用、编辑、重启与删除 MCP 服务器的需求,避免直接操作底层配置文件。
核心功能¶
- 列表与展开:在设置页面列出所有配置的 MCP 服务器。点击列表项可展开,查看该服务器当前注册到模型的所有工具及其描述。
- 启用与停用:通过写入补丁层的
disabled覆盖行实现。配置改动约 1 秒内热生效,无需重启 DSH。 - 编辑:支持两种模式。一种是表单模式,逐字段修改;另一种是 JSON 模式,打开即预填当前配置,支持整段粘贴替换。
- 重启与删除:重启用于连接中断后的恢复;删除用于从配置文件中移除服务器。
- 添加:直接粘贴任意主流工具的 MCP 配置,插件会自动识别格式(包括 Codex 的 TOML 格式与带注释的 JSON)。
- 多语言:支持中文与英文,默认跟随界面语言。
安装与启用¶
安装前请确保环境满足要求:DSH 版本在 0.1.6-alpha.1 到 0.3.0 之间,且 DSH 依赖的 Node.js >= 24.2.0 与 Git >= 2.31.0。
执行以下命令安装到 web profile:
dsh plugin --profile web add dsh-mcp-manager-plus
安装后重启 dsh 或等待热重载,进入「设置 → MCP 管理」即可看到新页面。
典型用法¶
- 打开 dsh web,进入设置 → MCP 管理。
- 点击「添加」按钮,粘贴 Codex 的
config.toml或其他工具的 JSON 配置,插件会自动识别并导入。 - 在编辑弹窗中,点击右上角的分段开关在「表单模式」和「JSON 模式」之间切换。
- 若需更新或卸载,可在命令行执行:
dsh plugin --profile web add dsh-mcp-manager-plus # 更新
dsh plugin --profile web remove dsh-mcp-manager-plus # 卸载
适用场景与注意事项¶
- 该插件以当前 dsh 进程的权限运行,请确保来源可信。
- 凭据在读取时会被掩码,不会显示在页面中。
- 部署内置的服务器是只读的,不能编辑或删除。
- 卸载插件后,profile 补丁层中由该插件写入的 MCP 服务器配置行会原样保留,不会被连带删除。
总结¶
dsh-mcp-manager-plus 通过提供可视化的界面,降低了 MCP 服务器配置的维护成本。支持多种配置格式的自动识别与编辑,能够满足在 DSH 环境下对 MCP 服务器进行全生命周期管理的需求。