MCP 服务器管理 railgun52/dsh-mcp-servers

dsh-mcp-servers — MCP 服务器设置页

DeepSeek Harness 的 profile-config 设置页，在 Web UI 里管理 MCP 服务器，并把保存的服务器列表挂成实时运行的 mcp-client 实例。

你添加的每个服务器都会成为一个运行中的 MCP 客户端，其工具会注册到智能体工具表上——保存即生效，模型马上能调用，无需重启、无需手改 YAML。页面是对 mcp-servers profile-config 命名空间的 JSON 编辑器；Host 端负责 schema 与实时桥，浏览器端负责编辑卡片。

功能

| 功能 | 说明 |
| 设置页 | 一级设置 section MCP 服务器，提供增/改/删卡片列表 |
| JSON 编辑器 | 用一个文本框编辑整段 servers 数组；一键添加服务器 |
| 实时桥 | Host 为每个启用的服务器挂一个 mcp-client 实例，并在每次设置改动时（loader/volatile-update）重同步，不重载插件 |
| stdio + streamable-http | 每个服务器含 name、command、args、env、transport、url、enabled |
| profile-config 存储 | 值持久化到当前 profile 的插件配置；页面通过共享 configForms 命名空间读写 |

架构

dsh-mcp-servers/
|-- src/
| |-- index.ts # host 端：Config schema（volatile servers）+ mcp-client 桥
| |-- mcp-servers-schema.ts # McpServersSchema + McpServerConfig
| |-- mcp-bridge.ts # applyMcpBridge：按实时值创建/销毁 mcp-client 实例
| |-- invariant.ts
| -- client/
| |-- index.ts # 浏览器端：configForms.whileServed + settings.section 卡片
| |-- McpSection.tsx # JSON 编辑卡片（经 configForms load/save）
| |-- McpSection.module.css
| -- locales.ts # zh/en 导航与页面文案
-- cordis.patch.yml # bundle patch：插入 mcp-servers 插件行

- 命名空间：mcp-servers。所属 profile 条目 id 必须等于该字符串；在 profile-config 设置模型下，插件的 Config schema 即命名空间。
- 实时编辑：servers 声明为 .volatile()，设置模型据此暴露命名空间，且编辑不重载插件；Host 通过 Volatile.get() 读实时值，并在 loader/volatile-update 时重同步桥。
- 浏览器 bundle：走 window.__ModuleLoader__.load 契约；React 与 @deepseek-ai/dsh-client-ui-primitives 从加载器模块表解析（external）；CSS Modules 由 lightningcss 内联为 。

安装

从本地目录（开发）
dsh plugin --profile web add link:/absolute/path/to/dsh-mcp-servers

从 npm（推荐）
dsh plugin --profile web add @railgun52/dsh-mcp-servers@latest

安装后重启 dsh web。打开 设置 → MCP 服务器 管理服务器。link 模式下改代码后跑 pnpm build 再刷新页面即可，无需重新安装。

开发

pnpm install
pnpm build # tsc -b（类型+声明）&& tsdown（node 半 + 浏览器 bundle）
pnpm typecheck # 仅类型检查

浏览器 bundle 用 harness 的 clientBundle helper 产出；从全新克隆构建需要 DeepSeek Harness 仓库在场（tsdown.config.ts 引入其 clientBundle）。发布的 lib/ 已预构建，使用者无需构建。

许可证

MIT