dsh-mcp-manager

> DeepSeek Harness（DSH）的 MCP 管理插件：在 Web GUI 设置页启停 profile 中的 mcp-client 服务器实例；停用的服务器断开连接，其工具（mcp__<server>__*）对 Agent 运行时不可见。

![license](LICENSE)

English · English README

适用于 DSH 0.1.0-rc.7 及以上的 bundle 插件模型（dsh.profile.bundles + dsh.bundle.patch）。工程模式与 dsh-skill-manager 完全一致（同作者姊妹插件）。

功能

本机配置源发现：读取 Claude Code / Claude Desktop 的 mcpServers 配置（~/.claude.json、项目 .mcp.json、Claude Desktop），面板一键导入挂载；本地地址条目自动探测运行状态（运行中 / 未运行）；SSE 协议条目明确标注「暂不支持挂载」
自动挂载目录：在 <harness home>/mcp-servers.json 声明服务器（兼容 mcpServers 风格），boot 时自动挂载为 mcp-client 实例；面板「重新扫描」实时增删/热更新
设置页管理面板：设置（Settings）→「MCP 管理」，列出全部 mcp-client 实例（serverName / 来源 / 传输类型 / 连接地址），支持搜索与「全部 / 已启用 / 已停用」筛选，一键开关
真启停：停用 = loader entry disabled（mcp-client fiber 被 dispose）——**断开连接、注销全部 mcp__<server>__* 工具**，对所有 Agent 及子 Agent 全局生效；启用 = 重新连接并注册工具
批量操作：工具栏「全部启用 / 全部停用」（停用全部需确认）
插件配置卡片：设置 → 插件 →「插件配置」出现 dsh-mcp-manager 卡片（服务端注册 settings 命名空间，rc.7+ keyed 分发）
持久化：禁用名单存于 <harness home>/mcp-manager.json，重启后 boot 时自动重新应用；已消失的 serverName 自动清理
headless 兼容：loader 硬依赖 + webServer 可选等待——无 Web GUI 的 headless profile 启停能力照常可用
零构建：单文件插件（ESM host + ModuleLoader client），无编译步骤

前提：接入 MCP 服务器（两种方式）

方式 A —— 自动发现（推荐）：在 <harness home>/mcp-servers.json（默认 ~/.dsh/mcp-servers.json）声明服务器，重启 dsh 或点面板「重新扫描」即自动挂载：

{
  "servers": {
    "filesystem": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    },
    "remote": {
      "transport": "streamable-http",
      "url": "https://your-mcp-server.example.com/mcp",
      "headers": { "Authorization": "Bearer sk-xxx" }
    }
  }
}

也接受 mcpServers 键（Claude Desktop 兼容）；transport 缺省时按有无 url 推断。改完点「重新扫描」：新增的挂载、移除的清理、变更的热更新（连接重置），全部无需重启。

方式 B —— patch 实例：在 profile 的 cordis.patch.yml 添加 @deepseek-ai/dsh-mcp-client 行（每实例一个服务器）：

- insert:
    - id: mcp-my-server
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: my-server          # 唯一标识（[A-Za-z0-9_-]{1,32}），管理面板按它列出行
        transport: stdio               # 或 streamable-http
        command: npx
        args: ['-y', '@some/mcp-server']

两种方式的实例统一出现在管理面板（来源标记「自动 / 配置」），均可启停；同 serverName 时 patch 实例优先（自动发现跳过重复）。更多选项见 @deepseek-ai/dsh-mcp-client Config。

自动发现本机已有的 MCP 配置

设置页「MCP 管理」底部的「本机配置源发现」区块会扫描你的：

来源	路径
Claude Code 全局	`~/.claude.json` → `mcpServers`
Claude Code 项目	`~/.mcp.json` → `mcpServers`
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` → `mcpServers`

每个条目显示：来源 · 协议（stdio / streamable-http / SSE）· 运行状态（仅本地地址会真实探测，3s 超时、30s 缓存；不做端口扫描）· 是否已挂载。可挂载条目（stdio / streamable-http）点「导入」即写入 mcp-servers.json 并立即挂载（幂等）；SSE 条目（如 JetBrains IDEA / DataGrip 的 MCP 插件）会显示「SSE，DSH 暂不支持挂载」——DSH 官方 dsh-mcp-client 目前只支持 stdio 与 streamable-http，等待服务器提供 streamable-http 端点后同一条目即可导入。

> 边界说明：发现的是配置清单而非进程扫描——本地已在运行的 stdio 进程没有网络入口（它是某个客户端的子进程），无法自动发现，用 mcp-servers.json 声明即可。发现 API 不会返回配置中的 env / headers 值（只显示是否存在），导入时原样保留进 mcp-servers.json。

安装

将下面的提示词复制给你的 AI 助手（Agent），它会按照 [AGENT.md](AGENT.md) 完成安装：

> 请阅读仓库根目录的 AGENT.md 文档，按照其中的步骤，在当前 DSH profile 中完成 dsh-mcp-manager 插件的安装、挂载与验证。

或手动安装：

# 1) 安装插件包（bundle：自动进入 dsh.profile.bundles，无需手工编辑 patch）
dsh plugin --profile web add dsh-mcp-manager                       # npm 已发布时
dsh plugin --profile web add github:welsione/dsh-mcp-manager       # 直接从 GitHub 装
#    固定版本（推荐，避免 main 漂移）：github:welsione/dsh-mcp-manager#v1.0.0
#    未 push 的本地开发：file: 前缀（实体化安装，依赖可解析；裸路径=link: 软链会失败）

# 2) 重启 dsh 进程（bundle 补丁层启动时加载），刷新 Web 页面

> git 依赖须知：github:… 装的是 GitHub 上已提交的代码——先 git push；固定版本用 #v1.0.0。

架构

文件	职责
`cordis.patch.yml`	bundle 补丁层：`dsh.bundle.patch` 指向它，boot 时自动挂载 host 插件行
`lib/index.js`	Host half（ESM）：遍历 loader entries 收集 mcp-client 实例；启停 = `entry.update({disabled})`（断开/重连连接）；本机配置源发现 + 导入（`GET /api/mcp-manager/discover`、`POST /api/mcp-manager/discover/import`）；HTTP API `GET /api/mcp-manager/list`、`POST /api/mcp-manager/set`（单/批量）、`POST /api/mcp-manager/rescan`；settings 命名空间注册；禁用名单持久化 + boot 重应用
`lib/client.js`	Client half：`window.__ModuleLoader__.load` 注册设置页「MCP 管理」与「插件配置」卡片；设置页导航图标替换为插头样式
`package.json`	`dsh.bundle.patch` + `dsh.client` 声明（bundle + 客户端随包加载）；ESM；`@deepseek-ai/dsh-settings` peer 依赖

验证

# 服务端路由
curl -s http://127.0.0.1:3080/api/mcp-manager/list | python3 -m json.tool
# 期望 ok:true、servers 为全部 mcp-client 实例、disabled 为停用名单

# 客户端 bundle（刷新页面后生效）
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3080/plugins/dsh-mcp-manager/client.js   # 期望 200

# 启停与批量
curl -s -X POST http://127.0.0.1:3080/api/mcp-manager/set \
  -H 'content-type: application/json' -d '{"serverName":"my-server","enabled":false}' | python3 -m json.tool
curl -s -X POST http://127.0.0.1:3080/api/mcp-manager/set \
  -H 'content-type: application/json' -d '{"serverNames":["a","b"],"enabled":true}' | python3 -m json.tool

# 单元测试（CI 同款，无需 DSH 进程）
npm install && npm test   # 期望 ALL PASS（12 项宿主逻辑检查）

卸载

1. dsh plugin --profile web remove dsh-mcp-manager（从依赖与 dsh.profile.bundles 移除） 2. 重启 dsh；mcp-manager.json 保留，重新安装后沿用禁用名单

生态与收录

本仓库满足 awesome-dsh-plugin 与 awesome-dsh-plugins 雷达的收录条件（dsh.bundle 声明 + cordis.patch.yml、真实可用代码 + test/host.test.mjs、CI 全矩阵）。GitHub 侧待办：git push origin main && git tag v1.0.0 && git push origin v1.0.0，仓库 About → Topics 添加 dsh-plugin（雷达每 6 小时自动收录并实机验证）；awesome 列表条目 YAML 样例：

url: https://github.com/welsione/dsh-mcp-manager
name: welsione/dsh-mcp-manager
category: tools                       # 管理 MCP 服务器实例 → tools 类
description:
  en: Enable or disable mcp-client server instances from the Web GUI settings page; disabled servers disconnect and their tools are hidden from every agent runtime.
  zh: 在 Web GUI 设置页启停 mcp-client 服务器实例；停用的服务器断开连接且工具对 Agent 运行时不可见。

dsh-mcp-manager-welsione

Install

Check the source files

dsh-mcp-manager

功能

前提：接入 MCP 服务器（两种方式）

自动发现本机已有的 MCP 配置

安装

架构

验证

卸载

生态与收录

相关

Source facts

Install

Check the source files

dsh-mcp-manager

功能

前提：接入 MCP 服务器（两种方式）

自动发现本机已有的 MCP 配置

安装

架构

验证

卸载

生态与收录

相关

More related plugins

dsh-mmx-bridge

dsh-skill-manager-welsione

ouroboros#integrations/dsh-plugin