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 官方源：https://www.npmjs.com/package/@guowenzhang/dsh-mcp-manager。装完重启宿主；本地目录开发安装、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:<preset id>:<serverName>）：

写法	含义
`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。

dsh-mcp-manager

Install

Source

Tags

Readme