zhang-guo-wen/dsh-mcp-manager

description: "MCP server management for DeepSeek Harness: author composition rows, choose when an allowed server loads, and filter which of its tools a session may call."
kind: "plugin-readme"

@guowenzhang/dsh-mcp-manager

背景：DeepSeek Harness

DeepSeek Harness（dsh）是 DeepSeek AI 开源的 agent harness，几乎所有能力都是 Cordis 插件。它处于 developer preview 阶段、迭代很快，会有破坏性变更（文档站，0.1.7-alpha.）；本插件是独立第三方包，@deepseek-ai/ 运行时从宿主解析。

这个插件解决什么问题

MCP 服务器原本只能手写组合行、整套工具常驻上下文，已有的 Claude Code 配置还得照着重敲；本插件在设置页管理这些行，按需加载某台服务器且只加载你勾选的那部分工具，还能一键导入 Claude 的 MCP 配置。

截图

设置 → MCP 管理 —— 加载方式与服务器行

MCP 管理页

三种加载方式，以及已配置的服务器：每行带所属平面、实时状态、「编辑」与启用开关。

新增 MCP —— JSON 配置与工具勾选

MCP 编辑弹窗

一台服务器的 JSON 配置，以及它发布的工具列表：默认全部勾选，取消勾选的方法不会交给模型。

导入 Claude MCP 配置 —— 勾选要带过来的服务器

导入 Claude MCP 配置

从 Claude Code 的配置文件里读到的每一台 MCP 服务器，勾中的导入为全局行。

安装

npx @deepseek-ai/dsh plugin --profile web add @guowenzhang/dsh-mcp-manager

来自 npm 官方源：。装完重启宿主；本地目录开发安装、git 源与排查见 AGENTS.md。

用法

加载方式

启用开关说的是这台服务器允不允许用，加载方式说的是允许的服务器什么时候进上下文。在 设置 → MCP 管理 → MCP 加载方式 里选；选择存在 mcp-manager 设置命名空间，从下一个请求起对所有会话生效。

| 模式 | 行为 |
|---|---|
| 全部加载（eager） | 允许的服务器在会话开始时就挂载，工具始终在请求里 |
| 动态插入（dynamic，默认） | 允许的服务器默认不挂载；mcp_load 把一台挂进调用方会话——绑定质量最好，但工具列表每次加载会变一次。配了工具过滤的行只挂可见工具 |
| 惰性（lazy） | mcp_load 只连不注册，把工具 schema 作为结果返回，模型经固定的 mcp_call 代理调用——工具列表永不变，请求缓存前缀零失效 |

dynamic / lazy 下，系统提示按 名字 — 你在这行写的描述 列出每一台可加载的服务器，模型按名字调 mcp_load / mcp_unload。名字永远列全；描述单条截断到 80 字符、整段预算 900 字符。加载状态刻意不写——写它会让每次 mcp_load 都重写系统提示，整个缓存前缀失效。

连接按会话隔离：同一会话重复 mcp_load 复用一份，不同会话各起一份，会话结束会关掉它开的连接；eager 相反，共享一个常驻实例。切换某一行的开关时先短暂显示 启动中 / 停止中，因为要等子进程起来。

工具过滤

设置 → MCP 管理 → 某一行的 编辑 → 工具列表 tab，列出这台服务器发布的所有方法，默认全勾。取消勾选即隐藏：不进上下文，调用也会被拒绝。过滤不改变代价模型——那由加载方式决定。

要写通配规则就自己写，规则在 mcp-manager 设置的 tools 字段里，键是行标识（preset::）：

| 写法 | 含义 |
|---|---|
| create_workitem | 白名单：只要有一个不带 ! 的条目，就只有匹配它的工具可见 |
| !delete_ | 黑名单：条目全是 ! 开头时，匹配的隐藏，其余保留 |
| 、? | 通配符：* 匹配任意长度的字符，? 匹配单个字符 |

规则在下一次 mcp_load 时读取，已经加载的服务器保持加载时那套工具。eager 下规则不生效，无法解析的规则什么都不隐藏。

导入 Claude Code 的 MCP 配置

设置 → MCP 管理 → 导入 Claude 配置 读取 Claude Code 自己写的那几个文件，把找到的服务器列成勾选清单，勾中的导入为全局行。

| 来源 | 文件 |
|---|---|
| Claude Code 用户配置 | ~/.claude.json 的 mcpServers |
| 其中的按目录分区 | ~/.claude.json 的 projects[""].mcpServers |
| Claude Code 设置 | ~/.claude/settings.json、settings.local.json |
| 项目级 | /.mcp.json |

扫描只读，不改动任何来源文件；每台服务器各自导入，一台失败不影响其余。env / headers 会一起带过去（否则连不上），但弹窗只显示这些键的名字。

注意事项

- 启用 MCP 仍需等子进程自身启动（npx -y … / uvx … 通常 1–3 秒）。界面不会卡住；把服务器装成直接可执行文件能明显缩短这个时间。
- 切到编辑弹窗的「工具列表」tab 会连一次该服务器（为了列出工具），同样是 1–3 秒；只改描述就不会连。
- 全局平面的行不受加载模式管辖：它们总是挂载。
- 预设首次挂载时会有一次"启动后又杀掉"：按需加载靠运行时摘行实现，抢在子进程启动之前拦不住，所以每次宿主重启后第一次使用某个 preset 时会有这一下。
- 导入只读 Claude Code 与项目的 .mcp.json：不扫 Cursor / Cline / Roo / VS Code 的配置文件；且导入一律落在全局平面，想要按需加载请在导入后把该行移进 preset。
- dynamic 下配了规则的行拿不到服务器 instructions 与资源工具：这两样由 harness 的 mcp-client 提供，而这一行走的是插件自己的注册通道。工具本身的参数绑定、结果与图片呈现与原生挂载一致。

许可

Apache License 2.0 —— 见 LICENSE。本项目包含源自 DeepSeek Harness 的 MIT 许可部分，见 NOTICE。

延伸阅读

- AGENTS.md —— 完整的安装变体、构建与接线、部署与生效语义、发版步骤、易崩清单与测试。
- docs/design-decisions.md —— 为什么是三种加载模式、否决过哪些替代方案、Claude 的 tool search 如何对照。
- docs/competitive-landscape.md —— 同类 DSH MCP 插件对比与由此产生的功能路线图。
- DeepSeek Harness 文档。