HuanLinOTO/dsh-plugin-mcp-manager

dsh-mcp-manager

DSH MCP 服务器管理插件 — GUI 增删改 MCP 服务器配置 + 工具浏览 + agent 面 mcp_ 管理工具。

定位

服务器连接管理 + 工具浏览。连接生命周期完全委托官方 @deepseek-ai/dsh-mcp-client——
本插件是注册表的「写配置层」+「状态/工具浏览层」，不自己拉连接。

GUI(Plugins 页「dsh-mcp-manager」行配置卡片) ──HTTP──> /api/mcp-manager ──读写──> profile cordis.patch.yml
Agent 面 mcp_ 工具 ─────────────────────────────┘        (mcp-client insert 行)
│ 配置 HMR 实时挂载
▼
官方 mcp-client 实例（连接+注册工具）
GUI 状态/工具浏览 ）
name: '@deepseek-ai/dsh-mcp-client'
disabled: true           # 可选 entry-level 字段：loader 跳过挂载，工具不注册，config 保留
config:
serverName: github    # 工具命名空间 mcp__github__*
transport: stdio      # stdio | streamable-http
command: npx
args: ['-y', '@modelcontextprotocol/server-github']
env: { GITHUB_TOKEN: '' }        # 明文（见下「Secret 处理」）
toolCallTimeoutMs: 60000
failOnStartupError: false

- 支持 stdio（command/args/env/cwd）与 streamable-http（url/headers）。
- 编辑 = 整块替换 config（不深合并，与 loader patch 语义一致）。
- 禁用 = 设置 entry-level disabled: true（与 id/name/config 同级，不在 config 内）。
loader 跳过挂载 → 工具不注册 → 模型不可见；启用 = 移除该字段。
- 写前用 eemeli yaml 解析 + 可选 loadOverlayPatches（app-boot）校验；写后失败自动回滚。
- 保留其他行的 !!js 表达式与注释（eemeli Document API 往返保留）。

运行

安装

本地开发（link: 热更新——改源码后 pnpm build 即可见）
dsh plugin --profile web add "link:"

远端（预构建 lib/ 入库，无 prepare，开箱即用）
dsh plugin --profile web add "github:dsh-external/dsh-mcp-manager"

安装后重启 dsh web（bundle 层在 boot 时加载），浏览器硬刷新（Ctrl+Shift+R）。

使用

- GUI：Plugins 页（插件列表）→ @huanlin/dsh-plugin-mcp-manager → dsh-mcp-manager 行 →
「配置」打开完整面板（行详情页的描述回退显示 summary 一行简介）。
- 新增/编辑/删除服务器；编辑表单内联在对应卡片下方（不在全局底部）。
- 禁用/启用服务器（不删除配置；禁用后 loader 跳过挂载，工具不注册，模型不可见）。
- 点击「工具」展开该服务器的 mcp__ 工具列表（禁用状态下不可展开）。
- Agent：模型可调用 mcp_server_list / mcp_server_add / mcp_server_update /
mcp_server_remove / mcp_server_set_enabled。

API 路由

| 路由 | 方法 | 说明 |
|------|------|------|
| /api/mcp-manager/servers | GET | 列出服务器 + 工具数 + 状态 + disabled |
| /api/mcp-manager/servers | POST | 新增（body: {config}）→ HMR 挂载 |
| /api/mcp-manager/servers/ | PUT | 编辑（整块替换 config） |
| /api/mcp-manager/servers/ | PATCH | 禁用/启用（body: {disabled: boolean}；config 保留） |
| /api/mcp-manager/servers/ | DELETE | 删除 |
| /api/mcp-manager/tools | GET | 工具浏览（mcp__ 前缀按 serverName 分组） |
| /api/mcp-manager/status | GET | 运行态状态（含 disabled） |

Secret 处理

⚠ P0：env / headers 以明文存入 profile cordis.patch.yml（与官方示例同形态）。
README 明确警示：勿放长期密钥；部署隔离。P1 可接 @deepseek-ai/dsh-credentials（待设计）。

检查（合规自检，对照 plugin-development-guide.md §10）

- [x] 零源码 patch：未修改 DSH checkout 任何文件
- [x] B1：package.json 声明 dsh.bundle.patch
- [x] B2：自带 cordis.patch.yml（insert 行 id/name 齐全）
- [x] B3：patch 行 name 用包名 @huanlin/dsh-plugin-mcp-manager
- [x] F1：files 含 lib/ + cordis.patch.yml
- [x] F2：peerDependencies 含 @deepseek-ai/cordis + @deepseek-ai/（dsh-tools / dsh-llm / dsh-app-boot / dsh-client-ui-primitives / dsh-client-ui-slots / dsh-client-ui-plugin-manager（type-only，plugins.row.config 契约）/ dsh-client-ui-renderer / dsh-client-locale，对齐 v0.1.7-rc.1）
- [x] F3：typecheck / test / build 三 script 齐全（预构建策略：无 prepare，lib/ 入库）
- [x] A4：Config 校验用 validateServerConfig（fail loud，携带字段名）
- [x] A6：不导出 default
- [x] C4：工具返回规范 JSON 值 + render 投影分离
- [x] G：测试分层（Unit：35 用例覆盖增删改/禁用/唯一/非法拒绝/!!js 保留/空文件/多行）
- [x] README：含开发/运行/检查三节

预构建策略说明

含 @deepseek-ai/* private peer deps → 采用预构建 lib/ 入库策略：
lib/ 不进 .gitignore，无 prepare 脚本。github: 安装开箱即用（pnpm 在 git install 的
prepare 阶段拉不到 private 包，故不能用 prepare 策略）。