dsh-mcp-workbench
官方 DeepSeek Harness MCP client 的 MCP 管理控制台 —— 在左侧栏的 MCP 页面里增删改 MCP 服务器、试用工具调用，配以诚实的连接状态、健康诊断与安全可逆的 profile 写入。
官方 client = 桥接，本插件 = 控制台：经 mcp/status seam 读取状态，只写入只追加、走审批的 profile patch。
> 这是个人 fork。 基于 PerryLink/dsh-mcp-panel 修改，仅供本人使用；上游的作者与维护归 PerryLink，本仓库与其无隶属关系，也不提供官方支持。
dsh plugin --profile add github:2239058652/dsh-mcp-workbench
📖 生态实测知识库（实测数据，不是营销）：插件开发指南 · 选型实测数据 · 维护取舍判据。
<!-- star-cta -->
Install & uninstall
- git 通道（最新
main）：dsh plugin --profile web add github:2239058652/dsh-mcp-workbench——prepare脚本只用生产依赖构建。 - npm 通道：本 fork 没有发布到 npm（
dsh-mcp-workbench在 npm 上不属于这个仓库），请用上面的 git 通道。 - tarball 通道：在本仓库
pnpm pack，再dsh plugin --profile web add ./dsh-mcp-workbench-.tgz。 - 卸载：从
cordis.patch.yml移除mcp-workbench行（web 面板热重载），从 profile 的node_modules删除本包，并用dsh web --dump-config确认没有残留的mcp-workbench行。
What is dsh-mcp-workbench?
官方 DeepSeek Harness MCP client 的 MCP 管理控制台 —— 在左侧栏的 MCP 页面里增删改 MCP 服务器、试用工具调用，配以诚实的连接状态、健康诊断与安全可逆的 profile 写入。
官方 client = 桥接，本插件 = 控制台：经 mcp/status seam 读取状态，只写入只追加、走审批的 profile patch。
工作流概览：安装 → 打开面板 → 操作。下面的示例使用实际命令面。
同一次运行，动图版。
Compatibility
| 维度 | 状态 |
|---|---|
| 宿主 | DeepSeek Harness dsh-v0.2.1-rc.2（2026-10-18 验证）：engines.dsh >=0.2.1-0 <0.3.0；P0 兼容路径已有回归测试。 |
| Node | ^22.19.0 \|\| >=24.0.0 |
| 平台 | Web GUI（双面：Host + 浏览器） |
| 模型 | 任意（面板只读；仅 /mcp 输出对模型可见） |
What you get
dsh-mcp-workbench 是官方 MCP client 之上的体验层：只读运行时视图加上安全可逆的 profile 写入。
/mcp命令 —— 每 server 一行：transport、目标、工具数、连接状态（来自上游 seam；未观测时如实显示unknown）、最近错误、重连计数——模型可读、会话日志可重建、五种输出语言。/mcp tools—— 模型可见的mcp__*工具名与描述。/mcp health—— 派生自愈建议（ENOENT → 依赖缺失、ECONNREFUSED、超时、401/403/404、DNS、限流、重连耗尽…）；退出码 / stderr 尾部如实标注待官方支持。/mcp call [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____ 工具名。本插件从不取代它——而是构建其上的体验层：
┌────────────────────────────────────────────┐
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.yml | dsh-mcp-workbench 控制台 | |
|---|---|---|
| 添加服务器 | 改 YAML，注意缩进与引号 | 表单 → patch 片段 → 一键复制或写入（审批 + 自动备份） |
| 修改服务器 | 改 YAML，重启/热重载 | 表单预填当前行；未改动的密钥在 host 侧保留原值 |
| 删除服务器 | 删掉该行 | 追加 - id: + disabled: true 覆盖操作（patch 词汇表没有 remove）——可随时重新启用 |
| 查看状态 | 翻日志 | 徽章 + 重连次数 + 最近错误，来自 mcp/status seam 实时数据 |
| 试用工具 | 让模型调用 | 弹窗内试用 → 官方 ctx.tools.execute() 管线（权限与审批全程生效） |
| 排查故障 | grep 日志 | /mcp health 派生自愈建议 |
| 误操作 | 手动回滚 | 每次写入只追加、留时间戳备份 |
控制台的输出就是 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
# 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 tools/mcp health
Configuration
所有可调项都是 Schemastery Config 字段（可从 cordis.yml 覆盖）。cordis.patch.yml 逐键内联注释。
| 键 | 默认值 | 含义 |
|---|---|---|
probeEnabled |
true |
注册 mcp_probe 后台任务工具（结果仅面板可见） |
probeTimeoutMs |
10000 |
单次探测超时（ms） |
maxProbes |
10 |
面板展示的探测记录数 |
refreshIntervalMs |
0 |
建议的面板刷新间隔（ms）；0 = 按需 |
outputLanguage |
en |
/mcp 输出语言：en \| zh \| es \| pt \| hi |
passiveProbeEnabled |
false |
周期性探测 streamable-http 服务器 |
passiveProbeIntervalMs |
60000 |
被动探测间隔（ms） |
trialEnabled |
true |
工具试用（MCP 页面 + /mcp call） |
trialTimeoutMs |
120000 |
每次试用调用的面板侧截止时间（ms） |
trialMaxResultChars |
60000 |
试用结果载荷上限（字符） |
writeEnabled |
true |
总开关：false 拒绝一切 profile 写入（仍可复制片段） |
writeVerifyEnabled |
true |
每次写入在报成功前对照 loader 重放后的状态复验 |
writeVerifyTimeoutMs |
3000 |
写入复验的轮询预算（毫秒） |
backupCount |
5 |
每次写入保留的 cordis.patch.yml 备份数 |
catalogEntries |
[] |
推荐服务器目录的用户覆盖：追加条目，同 id 的条目替换内置条目 |
Tools & surfaces
| 表面 | 类型 | 说明 |
|---|---|---|
/mcp |
command | 每 server 状态行；模型可读、日志可重建 |
/mcp tools |
command | 模型可见的 mcp__* 工具名与描述 |
/mcp health |
command | 由脱敏错误文本派生的自愈建议 |
/mcp call [json] |
command | 经官方工具管线试用调用 |
mcp_probe |
tool | 可选 Streamable HTTP 连通性探测（后台任务） |
| 左侧栏 → MCP 页 | UI 槽位（main 面板 + 侧栏条目） |
服务器列表与弹窗：CRUD、工具试用、资源浏览、探测、重连 |
mcpWorkbench Typert Remote |
service | 只读快照通道（Host → client） |
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
- 权限：
dshWorkshopmanifest 声明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 跑全量门禁、提交并本地打 v 标签（绝不推送）。
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 合并）。
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 身份校验与你的确认。
