dsh plugin --profile <name> add dsh-mcp-workbench

📖 生态实测知识库（实测数据，不是营销）：插件开发指南 · 选型实测数据 · 维护取舍判据。

Install & uninstall

• git 通道（最新 main）：dsh plugin --profile web add github:2239058652/dsh-mcp-workbench —— prepare 脚本只用生产依赖构建。
• npm 通道（发布版本）：dsh plugin --profile web add dsh-mcp-workbench。
• tarball 通道：在本仓库 pnpm pack，再 dsh plugin --profile web add ./dsh-mcp-workbench-<version>.tgz。
• 卸载：从 cordis.patch.yml 移除 mcp-panel 行（web 面板热重载），从 profile 的 node_modules 删除本包，并用 dsh web --dump-config 确认没有残留的 mcp-panel 行。

⭐ 如果它帮到了你

这个插件是 DSH 插件家族的一员（95 个，全部 Apache-2.0）。如果你在用，给个 star —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

What is dsh-mcp-workbench?

官方 DeepSeek Harness MCP client 的 MCP 管理控制台 —— 在左侧栏的 MCP 页面里增删改 MCP 服务器、试用工具调用，配以诚实的连接状态、健康诊断与安全可逆的 profile 写入。

官方 client = 桥接，本插件 = 控制台：经 mcp/status seam 读取状态，只写入只追加、走审批的 profile patch。

工作流概览：安装 → 打开面板 → 操作。下面的示例使用实际命令面。

同一次运行，动图版。

Compatibility

What you get

dsh-mcp-workbench 是官方 MCP client 之上的体验层：只读运行时视图加上安全可逆的 profile 写入。

• /mcp 命令 —— 每 server 一行：transport、目标、工具数、连接状态（来自上游 seam；未观测时如实显示 unknown）、最近错误、重连计数——模型可读、会话日志可重建、五种输出语言。
• /mcp <server> tools —— 模型可见的 mcp__* 工具名与描述。
• /mcp <server> health —— 派生自愈建议（ENOENT → 依赖缺失、ECONNREFUSED、超时、401/403/404、DNS、限流、重连耗尽…）；退出码 / stderr 尾部如实标注待官方支持。
• /mcp <server> call <tool> [json] —— 经官方工具管线（ctx.tools.execute()）试用调用；pre-execute 权限策略、审批、guard、post-execute 全部生效。
• 左侧栏 → MCP 页 —— 服务器列表与弹窗（详情、工具试用、资源浏览、诊断）、server CRUD、刷新与重连、探测。
• Server CRUD —— 增删改表单 → 添加用 insert，编辑/删除用 id 定向覆盖（- id: + name: + disabled:/config:）→ 剪贴板复制或审批写入，自动备份，并在报成功前对照 loader 复验。
• Resources 浏览 —— 经官方 list_mcp_resources / list_mcp_resource_templates / read_mcp_resource 工具只读列出资源、模板与 URI 读取（由上游 @deepseek-ai/dsh-mcp-resources 服务桥接）；结果只显示在本页、绝不进入模型上下文。
• 工具试用 —— 在服务器弹窗里对任意 mcp__* 工具就地填参、调用、看结果；按 trialMaxResultChars 截断；仅面板可见、永不进入模型上下文。

Architecture: official client = bridge, this plugin = console

@deepseek-ai/dsh-mcp-client 是唯一的桥接层：每个 MCP server 一个插件实例，以手写 cordis.yml 行的形式配置，负责连接传输、同步工具并注册 mcp__<server>__<tool> 工具名。本插件从不取代它——而是构建其上的体验层：

                    ┌────────────────────────────────────────────┐
 profile            │  cordis.yml / cordis.patch.yml             │
 组合（每个         │   - id: mcp-github                          │
  server 一行，     │     name: '@deepseek-ai/dsh-mcp-client'     │
  手写）            │     config: { serverName, transport, … }    │
                    │   - id: mcp-panel                           │
                    │     name: dsh-mcp-workbench   ◄── 本插件        │
                    └───────────────┬────────────────────────────┘
                                    │
        ┌───────────────────────────┴───────────────────────────┐
        │                                                        │
   ┌────▼──────────────┐        ┌───────────────────────────┐    │
   │ @deepseek-ai/dsh- │        │ dsh-mcp-workbench（控制台）    │    │
   │ mcp-client        │        │                           │    │
   │ • 传输连接        │        │ • /mcp 命令               │    │
   │ • 工具同步        │        │ • 左侧栏 → MCP 页：       │    │
   │ • mcp__* 工具     │◄──────►│   CRUD、工具试用          │    │
   │ • mcp/status seam │ 状态   │ • 健康诊断                │    │
   └───────────────────┘        │ • 探测、能力一览          │    │
                                └───────────────────────────┘    │

控制台通过官方 client 已落地的 mcp/status 可观测 seam（事件 + mcpStatus 查询服务）、工具注册表与 loader 读取事实；写入只发生在 profile 的 patch 层——只追加、走审批、自动备份。传输、OAuth 与协议完全不动。

Console vs. hand-written cordis.yml

控制台的输出就是 cordis.patch.yml 的词汇表——你手写的那几行，由它生成、预览并安全落地。

Quick start

dsh plugin --profile web add github:2239058652/dsh-mcp-workbench

# 1. 把 bundle 安装进 profile
dsh plugin --profile web add github:2239058652/dsh-mcp-workbench

# 或从 npm（发布版本）
dsh plugin --profile web add dsh-mcp-workbench

# 2. 重启并校验该行
dsh --profile web --dump-config | grep -A3 'id: mcp-panel'

随后打开左侧栏 → MCP，或运行：

/mcp
/mcp everything tools
/mcp everything health
/mcp everything call echo '{"message": "hi"}'

示例

以下为插件真实入口；安装后调用一个即可。

详细示例

命令

/mcp github tools

输出

Tools of "github" (1, model-visible public names):
- mcp__github__create_issue — Create a new issue in a GitHub repository

来源 plugins/dsh-mcp-workbench/tests/command.spec.ts:99-110; renderer at src/command.ts:352-360

失败分支

输入

/mcp nope tools

输出

Unknown MCP server "nope" (configured: github)

来源 plugins/dsh-mcp-workbench/src/command.ts:104-105; plugins/dsh-mcp-workbench/tests/command.spec.ts:152-157

简短示例

• /mcp <server> tools
• /mcp <server> health

Configuration

所有可调项都是 Schemastery Config 字段（可从 cordis.yml 覆盖）。cordis.patch.yml 逐键内联注释。

Tools & surfaces

Resources & Prompts

Resources 已由上游桥接：base bundle 默认挂载 @deepseek-ai/dsh-mcp-resources，官方 client 把每个连接的资源 provider 注册进 ctx.mcpResources，该包拥有三个共享工具（list_mcp_resources、list_mcp_resource_templates、read_mcp_resource）。控制台特征探测该服务与已注册工具，并在每个 server 卡上提供只读 Resources 浏览（列表 / 模板 / URI 读取）——每次调用都走官方工具管线，结果只显示在本页、绝不进入模型上下文。

MCP prompt 模板与资源订阅仍待上游；能力一览中 Prompts 标注待官方支持。

Permissions & data

• 权限：dshWorkshop manifest 声明 network:outbound 与 native-code:none。
• 数据：面板只读；只写入只追加的 cordis.patch.yml 片段（走审批、先备份）。URL 查询凭据、userinfo 密码、header 值、Bearer token、JWT 在渲染前一律打码；配置的 headers 从不进入任何快照，env/header 的值绝不出 Host（编辑器只见 key）。

Security boundaries

• 桥接层仍是桥接层。 不改传输、OAuth、协议；每个 server 一行 mcp-client，与你手写完全一致。
• 不伪造状态。 无上游观测时连接字段显示 unknown / — 并标注 statusSource: 'derived'；退出码与 stderr 尾部绝不臆造。
• 写入只追加、走审批、先备份。 控制台从不改写 cordis.patch.yml：只追加生成的操作，保留最新 backupCount 份备份，并在报成功前对照 loader 重放后的状态复验（被跳过的补丁绝不显示为成功）。
• 零提示词注入。 本插件不注册任何提示词段落；对模型可见的文本只有两个工具/命令描述。

Known limitations

• prompt 模板与资源订阅 待官方支持——官方 client 桥接工具与资源，但未桥接 prompts 与订阅。
• 退出码 / stderr 尾部 在 client 暴露前如实标注待官方支持。
• 只读面板 —— 控制台从不伪造连接状态；不可观测字段显示 unknown / -1 / —。
• 写入复验而非保证 —— 控制台对照 loader 重放后的状态复验每次写入；loader 未应用时（例如该行由 $DSH_HOME/cordis.patch.yml 插入、profile 层补丁够不着）如实报失败。

Development

pnpm run typecheck && pnpm run typecheck:ci && pnpm test && pnpm run build && pnpm run verify:self-contained && pnpm run verify:artifacts && pnpm pack

scripts/verify-headless.mjs 启动真实 web profile 并打印 /mcp 实际输出。发布：node scripts/release.mjs <x.y.z> 跑全量门禁、提交并本地打 v<x.y.z> 标签（绝不推送）。

Topics

dsh, dsh-plugin, deepseek-harness, deepseek, cordis, mcp, mcp-client, observability, panel

Contributors

• @PerryLink —— 创建者与维护者。
• @xiaoyuyu6420 —— 诊断出干净 checkout 构建失败背后缺失的 client devDependencies（PR #5）。
• @feiler0 —— 贡献了 stdio MCP 服务器探测（通过 stdin/stdout 完成一次 MCP initialize 握手）（PR #7，以 PR #15 合并）。

PerryLink DSH Plugin Family

本项目是 PerryLink 维护的 DeepSeek Harness 插件家族成员。完整名单默认折叠，避免每个 README 的首屏被长表淹没；点击展开可查看每一行及其状态。

License

Apache License 2.0 © 2026 dsh-mcp-workbench contributors

从 DSH Desktop 市场安装

所有 PerryLink 插件均可在 DSH Desktop 内置市场中浏览：市场 → 来源 → 添加来源 → 粘贴 https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → 选中。安装仍需通过市场的 npm 身份校验与你的确认。