MCP 管理控制台 PerryLink/dsh-mcp-panel

dsh-mcp-panel

- 1024 store channel：先执行一次 npm i -g dsh1024，再执行 dsh1024 plugin --profile web add dsh-mcp-panel（计入 deepseek1024.com 的安装排名）。

dshfind

官方 DeepSeek Harness MCP 客户端的 MCP 管理控制台——在设置页里添加、编辑、删除、试调用 MCP 服务器，状态如实呈现，带健康诊断，配置档写入安全可回滚。

官方客户端 = 桥接层，本插件 = 控制台：通过 mcp/status 接缝读取状态，只写入追加式、需审批的配置档补丁。

官方仓库。 这是 dsh-mcp-panel 唯一的官方仓库，由 PerryLink 维护。其他账号下的同名仓库均与本项目无关。

dsh-doctor
DSH Market

English · 简体中文 · Español · Português · हिन्दी

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

📖 生态知识库——实测数据，不是营销话术：插件开发指南 · 插件选型数据 · 维护标准。

安装与卸载

- git channel（最新 main）：dsh plugin --profile web add github:PerryLink/dsh-mcp-panel——prepare 脚本只带生产依赖构建。
- npm 渠道（已发布版本）：dsh plugin --profile web add dsh-mcp-panel。
- tarball 渠道：在本仓库执行 pnpm pack，然后运行 dsh plugin --profile web add ./dsh-mcp-panel-<version>.tgz。
- 卸载：从 cordis.patch.yml 中删掉 mcp-panel 那一行（web 界面会热重载它），再从配置档的 node_modules 里删除这个包，最后用 dsh web --dump-config 确认没有残留的 mcp-panel 行。

⭐ 如果它帮到了你

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

English: part of a 95 plugin family for DeepSeek Harness. If it is useful, a star helps the next person find it — nothing is gated behind it.

dsh-mcp-panel 是什么？

这是官方 DeepSeek Harness MCP 客户端的 MCP 管理控制台 —— 在设置页里添加、编辑、删除 MCP 服务器，还能试调用，状态如实呈现，带健康诊断，配置档写入安全可回滚。

官方客户端 = 桥接层，本插件 = 控制台：通过 mcp/status 接缝读取状态，只写入追加式、需审批的配置档补丁。

dsh-mcp-panel 的工作流示意图：安装 → 打开面板 → 操作。

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

兼容性

| 层面 | 状态 |
| Harness | 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（双面：宿主 + 浏览器） |
| 模型 | 任意（面板只读；只有 /mcp 的输出对模型可读） |

你能得到什么

dsh-mcp-panel 是官方 MCP 客户端之上的体验层：只读的运行时视图，加上安全可回滚的配置档写入。

- /mcp 命令 —— 每个服务器一行：传输方式、目标、工具数量、连接状态（来自上游接缝；未观测到时为 unknown）、最近一次错误、重连次数 —— 模型可读，会话日志可重建，支持五种输出语言。
- /mcp <server> tools —— 模型可见的 mcp__ 工具名和描述。
- /mcp <server> health —— 推导出的自愈建议（ENOENT → 缺少依赖、ECONNREFUSED、超时、401/403/404、DNS、限流、重连耗尽……）；退出码 / stderr 尾部会如实标注为等待上游支持，直到客户端暴露这些信息。
- /mcp <server> disable / enable —— 关掉或重新打开某个服务器行，不用手改配置档补丁。
- /mcp <server> probe —— 对该服务器做一次 Streamable HTTP 连通性探测（后台任务）。
- /mcp <server> call <tool> [json] —— 通过官方工具管线（ctx.tools.execute()）试调用；执行前权限策略、审批、守卫，以及执行后处理，全部生效。
- 设置 → 插件 → MCP 标签页 —— 带徽章的状态卡片、诊断和探测，外加服务器增删改查和工具试调用控制台。
- 服务器 CRUD — 添加/编辑/删除表单 → 添加走 insert，编辑/删除走按 id 定向的覆盖（- id: + name: + disabled:/config:）→ 复制到剪贴板，或走审批门控的写入，自动备份并重新校验加载器。
- 资源浏览 — 只读的资源列表、模板列表和 URI 读取，走官方 list_mcp_resources / list_mcp_resource_templates / read_mcp_resource 工具（由随附的 @deepseek-ai/dsh-mcp-resources 服务桥接）；结果只在标签页里显示，绝不进入模型上下文。
- 推荐目录 — 内置社区 MCP 服务器目录（filesystem、git、github、fetch、playwright、……），在快照中提供；catalogEntries 追加/覆盖条目，catalogToConfigInput 把条目变成一键添加。
- 配置导入/导出 — exportConfigs() 把服务器行序列化成带版本号的 JSON 文档（!!js 行导出为 null 并附原因），importPreview() 把导出的内容解析回每个服务器的 add 补丁片段，供你审阅。
- 工具试用控制台 — 服务器 → mcp__ 工具 → JSON 参数 → 规范 JSON 结果 + 渲染内容；受 trialMaxResultChars 限制；仅面板可见，绝不进入模型上下文。

架构：官方客户端是桥，本插件是控制台

@deepseek-ai/dsh-mcp-client 是唯一的桥：每个 MCP 服务器对应一个插件实例，配置为手写的 cordis.yml 行，负责连接传输、同步工具、注册 mcp__<server>__<tool> 名称。本插件从不替代它 —— 本插件是叠在它上面的体验层：

┌────────────────────────────────────────────┐
profile │ cordis.yml / cordis.patch.yml │
composition │ - id: mcp-github │
(one row per │ name: '@deepseek-ai/dsh-mcp-client' │
server, hand- │ config: { serverName, transport, … } │ written) │ - id: mcp-panel │ │ name: dsh-mcp-panel ◄── this plugin │ └───────────────┬────────────────────────────┘ │ ┌───────────────────────────┴───────────────────────────┐ │ │ ┌────▼──────────────┐ ┌───────────────────────────┐ │ │ @deepseek-ai/dsh- │ │ dsh-mcp-panel (console) │ │ │ mcp-client │ │ │ │ │ • transport │ │ • /mcp command │ │ │ • tool sync │ │ • Settings → Plugins → │ │ │ • mcp__* tools │◄──────►│ MCP tab: CRUD, trial │ │ │ • mcp/status seam │ status │ • health diagnostics │ │ └───────────────────┘ │ • probes, capabilities │ │ └───────────────────────────┘ │ 控制台通过提议的 mcp/status 可观测性接缝读取客户端（上游尚未发布；按特性检测）（事件 + mcpStatus 查询服务）、工具注册表和加载器；它只写入配置档的补丁层——仅追加、需审批、始终备份。传输、OAuth 和协议保持不动。

控制台 vs. 手写 cordis.yml

| | 手写 cordis.yml | dsh-mcp-panel 控制台 |
| 添加服务器 | 编辑 YAML，注意缩进和引号 | 表单 → 补丁片段 → 复制或写入（审批 + 自动备份） |
| 编辑服务器 | 编辑 YAML，重启/热重载 | 表单从实时行预填；未改动的密钥在宿主侧保留原始值 |
| 移除服务器 | 删除该行 | - id: + disabled: true 覆盖（补丁词汇表没有 remove）——随时可重新启用 |
| 查看状态 | 读日志 | 徽章 + 重连 + 最近错误，实时来自 mcp/status 接缝 |
| 试用工具 | 让模型调用它 | 试用控制台 → 官方 ctx.tools.execute() 流水线（权限与审批仍然生效） |
| 诊断失败 | 翻日志 | /mcp <server> health，附带推导出的自愈建议 |
| 出错 | 手动回滚 | 每次写入都是仅追加，并留下带时间戳的备份 |

控制台的输出就是 cordis.patch.yml 词汇表——和你手写的一样的行，生成、预览并安全应用。

快速开始

dsh plugin --profile web add github:PerryLink/dsh-mcp-panel

1. install the bundle into your profile
dsh plugin --profile web add github:PerryLink/dsh-mcp-panel

or from npm (published releases)
dsh plugin --profile web add dsh-mcp-panel

2. restart and verify the row
dsh --profile web --dump-config | grep -A3 'id: mcp-panel'

然后打开 Settings → Plugins → MCP，或运行：

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

示例

这些是插件的真实入口；安装一次，然后调用其中一个。

详细示例

命令

~~~sh
/mcp github tools

输出

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

观察自 plugins/dsh-mcp-panel/tests/command.spec.ts:99-110; renderer at src/command.ts:352-360

失败分支

输入

~~~text
/mcp nope tools

输出

~~~text
Unknown MCP server "nope" (configured: github)

观察自 plugins/dsh-mcp-panel/src/command.ts:104-105; plugins/dsh-mcp-panel/tests/command.spec.ts:152-157

简要示例

- /mcp <server> tools
- /mcp <server> health

配置

所有可调项都是 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 call） |
| trialTimeoutMs | 120000 | 面板侧单次试用调用的截止时间，单位 ms |
| trialMaxResultChars | 60000 | 试用结果载荷的字符数上限 |
| writeEnabled | true | 总开关：设为 false 时拒绝所有配置档写入（复制仍可用） |
| writeVerifyEnabled | true | 每次写入后，对照加载器重新应用的状态再校验一遍，确认无误才报告成功 |
| writeVerifyTimeoutMs | 3000 | 写入校验的轮询预算，单位 ms |
| backupCount | 5 | 每次写入保留的 cordis.patch.yml 备份份数 |
| catalogEntries | [] | 推荐服务器目录的用户覆盖层：条目追加，id 相同的条目替换内置条目 |

工具与界面入口

| 入口 | 类型 | 说明 |
| /mcp | 命令 | 按服务器列出的状态行；模型可读，日志可重建 |
| /mcp <server> tools | 命令 | 模型可见的 mcp__ 工具名 + 描述 |
| /mcp <server> health | 命令 | 根据脱敏后的错误文本给出自愈建议 |
| /mcp <server> disable / enable | 命令 | 在配置档补丁中切换单个服务器条目 |
| /mcp <server> probe | 命令 | 一次 Streamable HTTP 连通性探测（后台任务） |
| /mcp <server> call <tool> [json] | 命令 | 走官方工具管道的试用调用 |
| mcp_probe | 工具 | 可选的 Streamable HTTP 连通性探测（后台任务） |
| 设置 → 插件 → MCP 页签 | UI 插槽 | 状态卡片、服务器增删改查、工具试用控制台 |
| mcpPanel Typert Remote | 服务 | 只读快照通道（host → client） |

资源与提示词

资源确实做了上游桥接：基础包挂载 @deepseek-ai/dsh-mcp-resources，官方客户端把每个连接的资源服务商注册进 ctx.mcpResources，三个共享工具（list_mcp_resources、list_mcp_resource_templates、read_mcp_resource）由该包负责。控制台会探测服务和已注册工具是否存在，并在每张服务器卡片上提供只读的资源浏览器（列表 / 模板 / 按 URI 读取）——每次调用都走官方工具管道，结果不会进入模型上下文。

MCP 提示词模板和资源订阅仍在上游排期中；能力面板把 Prompts 标为等待上游支持。

权限与数据

- 权限：dshWorkshop 清单声明了 network:outbound 和 native-code:none。
- 数据：面板只读；只写入追加式的 cordis.patch.yml 片段（需审批，先备份）。渲染前会隐去 URL 查询凭据、userinfo 密码、请求头值、bearer token 和 JWT；配置的 headers 绝不进入任何快照，env/header 的值绝不离开主机（编辑器只能看到键）。

安全边界

- 桥接层保持原样。 不改传输、OAuth 或协议；每个服务器一行 mcp-client，与手写完全一致。
- 不伪造状态。 没有上游观测的连接字段读作 unknown / —，并带 statusSource: 'derived'；退出码和 stderr 尾部绝不编造。
- 写入是追加式、需审批、先备份的。 控制台从不重写 cordis.patch.yml；它追加生成的操作，保留最新的 backupCount 份备份，并在报告成功前，对照加载器重新应用后的状态复核每次写入（被跳过的补丁绝不会读作成功）。
- 无提示词注入。 面板不注册任何提示词段；它面向模型的文本只有两条工具/命令描述。

已知限制

- 提示词模板与资源订阅 待上游支持——官方客户端桥接工具和资源，但不桥接提示词或订阅。
- 退出码 / stderr 尾部 标注为待上游支持*，直到客户端暴露它们。
- 只读面板——控制台从不伪造连接状态；不可观测的字段读作 unknown / -1 / —。
- 写入经过复核，但不保证成功——控制台对照加载器重新应用后的状态复核每次写入，加载器未应用时如实失败（例如由 $DSH_HOME/cordis.patch.yml 插入的行，配置档层补丁无法触及）。

开发

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 配置档，并打印确切的 /mcp 输出。发布：node scripts/release.mjs <x.y.z> 运行完整门禁、提交，并在本地打标签 v<x.y.z>（绝不推送）。

主题

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

贡献者

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

PerryLink DSH 插件家族

本项目属于 PerryLink 的 DeepSeek Harness 插件家族。下方名册默认折叠，让每个 README 的首屏保持简短；展开即可查看每一行及其状态。

展开全部插件

| 插件 | 状态 |
| dsh-aqua-input-check | |
| dsh-archive-check | |
| dsh-auto-review | |
| dsh-autotier | |
| dsh-bid-ca-precheck | |
| dsh-bid-qual-check | |
| dsh-cert-mcp | |
| dsh-checkpoint-rewind | |
| dsh-click | |
| dsh-composer-history | |
| dsh-contract-stance | |
| dsh-customs-doc-check | |
| dsh-data-quality | |
| dsh-demurrage-ledger | |
| dsh-doublecheck | |
| dsh-drill-script-check | |
| dsh-eia-guide-check | |
| dsh-emergency-plan | |
| dsh-essay-rubric-check | |
| dsh-evidence-check | |
| dsh-export-ctl-check | |
| dsh-fast | |
| dsh-fmea-table-check | |
| dsh-forecast-penalty | |
| dsh-fund-research | |
| dsh-github | |
| dsh-gongwen-flow-check | |
| dsh-gongwen-word-check | |
| dsh-guard-plan-qc | |
| dsh-hazchem-check | |
| dsh-hazplan-check | |
| dsh-hidden-risk-map | |
| dsh-hs-classify | |
| dsh-icd-rule-check | |
| dsh-industry-research | |
| dsh-lawcite-adapter | |
| dsh-laya | |
| dsh-lc-doc-check | |
| dsh-learning-gap-check | |
| dsh-library | |
| dsh-local-ai | |
| dsh-lsp-actions | |
| dsh-mask | |
| dsh-mcp-panel | |
| dsh-medrec-qc | |
| dsh-memento | |
| dsh-nsfc-form-check | |
| dsh-nurse-record-check | |
| dsh-observe | |
| dsh-origin-rvc-check | |
| dsh-ota-review-check | |
| dsh-output-styles | |
| dsh-paper-doc-adapter | |
| dsh-permission-rules | |
| dsh-permit-report-check | |
| dsh-pipeline-check | |
| dsh-pleading-draft | |
| dsh-plugin-doctor | |
| dsh-plugin-guide | |
| dsh-plugin-kit | |
| dsh-plugin-upgrade | |
| dsh-policy-brief-draft | |
| dsh-power-loss-split | |
| dsh-power-ticket-check | |
| dsh-ppap-check | |
| dsh-protest-deadline | |
| dsh-railway-window | |
| dsh-repair-order-qc | |
| dsh-research-report | |
| dsh-review-reply-check | |
| dsh-rulefile-check | |
| dsh-safety-brief-check | |
| dsh-score | |
| dsh-session-sync | |
| dsh-site-log-check | |
| dsh-skill-pack-security | |
| dsh-soe-decision-check | |
| dsh-soilwater-check | |
| dsh-sop-sync-check | |
| dsh-spc-gbt-adapter | |
| dsh-talk | |
| dsh-tender-extract | |
| dsh-tender-matrix | |
| dsh-test-drive | |
| dsh-ticktick | |
| dsh-translate | |
| dsh-warranty-calc | |
| dsh-budget | 🧊 已冻结 — 见仓库 README |
| dsh-claude-move | 🧊 已冻结 — 见仓库 README |
| dsh-defend | 🧊 已冻结 — 见仓库 README |
| dsh-draw | 🧊 已冻结 — 见仓库 README |
| dsh-reach | 🧊 已冻结 — 见仓库 README |
| dsh-background-agents | 🚫 已退役 — 见仓库 README |
| dsh-session-pin | 🚫 已退役 — 见仓库 README |
| dsh-team-rooms | 🚫 已退役 — 见仓库 README |

许可证

Apache License 2.0 © 2026 dsh-mcp-panel contributors