前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在本地开发或部署智能体时,管理 MCP (Model Context Protocol) 服务器的配置往往需要手动编辑 YAML 文件或重启服务,这增加了调试成本。dsh-mcp-servers 插件解决了这个问题,它为 DSH 的 Web 界面提供了一个设置页面,允许用户通过 JSON 编辑器管理配置,并自动挂载活跃的 mcp-client 实例。
这是什么¶
railgun52/dsh-mcp-servers 是一个配置页面插件,属于客户端类别。它通过一个 JSON 编辑器覆盖 profile-config 命名空间,用于保存服务器列表,并挂载从这些列表中读取的活跃 mcp-client 实例。该插件由 railgun52 维护,拥有 1 个 Star,并采用 MIT 许可证。
核心功能¶
设置页面¶
在 Web 界面的设置中新增一级分区「MCP 服务器」。该分区提供了添加、编辑和移除服务器的卡片列表。
JSON 编辑器¶
用户可以直接在文本框中编辑整个 servers 数组。通过点击添加服务器,可以快速完成配置。
实时桥接¶
插件会在主机端为每个启用的服务器挂载一个 mcp-client 实例。每次编辑设置后,桥接层会自动同步(re-sync),无需重新挂载插件即可生效。
传输协议与配置¶
支持两种传输方式:stdio 和 streamable-http。每个服务器配置包含以下字段:
* name: 服务器名称
* command: 启动命令
* args: 命令参数
* env: 环境变量
* transport: 传输类型
* url: HTTP 地址(当传输类型为 streamable-http 时)
* enabled: 是否启用
数据持久化¶
配置值会持久化保存到当前激活的 Profile 的插件配置中。
安装与启用¶
安装此插件需要使用 npm 包。在终端中执行以下命令:
dsh plugin --profile web add @railgun52/dsh-mcp-servers@latest
命令执行完毕后,必须重启 dsh web 才能加载新的插件。
典型用法¶
- 重启
dsh web后,打开 Web 界面,导航至「设置」->「MCP 服务器」。 - 在该页面中,你可以直接编辑 JSON 来管理服务器列表。
- 如果在链接模式(link mode)下开发,修改代码后运行
pnpm build并刷新浏览器页面即可,无需重新执行安装命令。
适用场景与注意¶
- 版本要求:此插件依赖
@deepseek-ai/dsh >= 0.1.7-rc.1。 - 浏览器构建:虽然插件自带
lib/预构建文件,但构建浏览器包时需要 DeepSeek Harness 仓库可用(源码开发时需注意)。 - 配置权限:插件以当前 DSH 进程的权限运行,请确保源码安全且许可证符合你的需求。
短结尾¶
通过这个插件,你可以在浏览器中完成 MCP 服务器的配置与即时测试,无需离开 Web 界面。更多信息和源码,请访问项目主页。