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

dsh-mcp-panel
- 1024 商店渠道：先执行一次 npm i -g dsh1024，然后执行 dsh1024 plugin --profile web add dsh-mcp-panel（计入 deepseek1024.com 安装排名）。
Gitee

官方 DeepSeek Harness MCP 客户端的 MCP 管理控制台——在设置页面中添加、编辑、删除和试调用 MCP 服务器，提供诚实的运行状态、健康诊断，以及安全、可回滚的 profile 写入。

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

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

License
DSH plugin
dsh-doctor
Node
CI
Version
npm version
npm downloads

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

兼容性

| 层面 | 状态 |
|---|---|
| Harness | DeepSeek Harness dsh-v0.1.6-alpha.1（GitHub tag，2026-09-16 验证）：完整门禁链（typecheck / typecheck:ci / test / build / verify / package），并针对 0.1.6-alpha.1 检出执行 profile 安装冒烟测试。随附的 @deepseek-ai/dsh-mcp-resources 服务现已桥接 Resources，控制台会对其进行特性检测并以只读方式浏览。此前基线：dsh-v0.1.5-rc.2（2026-09-11 验证）。 |
| Node | ^22.19.0 \|\| >=24.0.0 |
| 平台 | Web GUI（双面：宿主 + 浏览器） |
| 模型 | 任意（面板为只读；仅 /mcp 输出可被模型读取） |

你将获得

dsh-mcp-panel 是官方 MCP 客户端之上的体验层：一个只读的运行时视图，加上安全、可回滚的 profile 写入。
- /mcp 命令 — 每个服务器一行：传输方式、目标、工具数量、连接状态（来自上游接缝；未观测时为 unknown）、最后错误、重连次数 — 模型可读、会话日志可重建、五种输出语言。
- /mcp  tools — 模型可见的 mcp__ 工具名称和描述。
- /mcp  health — 派生的自愈建议（ENOENT → 缺少依赖、ECONNREFUSED、超时、401/403/404、DNS、速率限制、重连耗尽……）；退出码 / stderr 尾部在客户端暴露它们之前被如实标注为待上游支持。
- /mcp  disable / enable — 无需手动编辑 profile 补丁即可关闭或重新开启某个服务器行。
- /mcp  probe — 对该服务器执行一次 Streamable HTTP 连通性探测（后台任务）。
- /mcp  call  [json] — 通过官方工具流水线（ctx.tools.execute()）进行试调用；执行前权限策略、审批、守卫以及执行后处理均适用。
- 设置 → 插件 → MCP 标签页 — 带徽章的状态卡片、诊断信息和探测，外加服务器 CRUD 和工具试用控制台。
- 服务器 CRUD — 添加/编辑/删除表单 → 添加时用 insert，编辑/删除时用按 id 定位的覆盖（- id: + name: + disabled:/config:）→ 剪贴板复制或经审批门控的写入，并自动备份和加载器重新验证。
- 资源浏览 — 通过官方 list_mcp_resources / list_mcp_resource_templates / read_mcp_resource 工具（由随附的 @deepseek-ai/dsh-mcp-resources 服务桥接）进行只读资源列表、模板列表和 URI 读取；结果仅在标签页中显示，绝不进入模型上下文。
- 推荐目录 — 快照中提供的内置社区 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____ 名称。本插件从不替代它 — 它是其上的体验层：

┌────────────────────────────────────────────┐
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  health，附带推导出的自愈建议 |
| 出错 | 手动还原 | 每次写入都是仅追加，并留下带时间戳的备份 |

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

快速开始

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

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"}'

安装与卸载

- git 渠道（最新的 main）：dsh plugin --profile web add "github:PerryLink/dsh-mcp-panel#main" —— prepare 脚本仅使用生产依赖进行构建。
- npm 渠道（已发布的版本）：dsh plugin --profile web add dsh-mcp-panel。
- tarball 渠道：在本仓库中运行 pnpm pack，然后执行 dsh plugin --profile web add ./dsh-mcp-panel-.tgz。
- 卸载：从 cordis.patch.yml 中移除 mcp-panel 行（web 界面会热重载它），从配置文件的 node_modules 中删除该包，并用 dsh web --dump-config 验证不再残留任何 mcp-panel 行。

配置

所有可调项均为 Schemastery Config 字段（可从 cordis.yml 修改）。cordis.patch.yml 以内联方式记录了常用键；完整的键列表见下表。

| 键 | 默认值 | 含义 |
|---|---|---|
| probeEnabled | true | 注册 mcp_probe 后台任务工具（仅面板结果） |
| probeTimeoutMs | 10000 | 每次探测的超时时间（毫秒） |
| maxProbes | 10 | 面板中显示的探测记录数 |
| refreshIntervalMs | 0 | 建议的面板刷新间隔（毫秒）；0 = 按需刷新 |
| outputLanguage | en | /mcp 输出语言：en \| zh \| es \| pt \| hi |
| passiveProbeEnabled | false | 定期探测 streamable-http 服务器 |
| passiveProbeIntervalMs | 60000 | 被动探测间隔（毫秒） |
| trialEnabled | true | 工具试用控制台（设置选项卡 + /mcp call） |
| trialTimeoutMs | 120000 | 每次试用调用的面板侧截止时间（毫秒） |
| trialMaxResultChars | 60000 | 试用结果负载的字符数上限 |
| writeEnabled | true | 终止开关：false 会拒绝所有配置文件写入（复制仍可用） |
| writeVerifyEnabled | true | 在报告成功之前，根据加载器重新应用的状态重新验证每次写入 |
| writeVerifyTimeoutMs | 3000 | 写入验证的轮询预算（毫秒） |
| backupCount | 5 | 每次写入保留的 cordis.patch.yml 备份数 |
| catalogEntries | [] | 推荐服务器目录的用户覆盖层：条目会追加，具有相同 id 的条目会替换内置条目 |

工具与界面

| 界面 | 类型 | 备注 |
|---|---|---|
| /mcp | 命令 | 每个服务器的状态行；模型可读且可从日志重建 |
| /mcp  tools | 命令 | 模型可见的 mcp__ 工具名称 + 描述 |
| /mcp  health | 命令 | 从经过清理的错误文本中得出的自愈建议 |
| /mcp  disable / enable | 命令 | 在配置文件补丁中切换一个服务器行 |
| /mcp  probe | 命令 | 一次 Streamable HTTP 连接探测（后台任务） |
| /mcp  call  [json] | 命令 | 通过官方工具管道进行试用调用 |
| mcp_probe | 工具 | 可选的 Streamable HTTP 连接探测（后台任务） |
| 设置 → 插件 → MCP 标签页 | UI 插槽 | 状态卡片、服务器增删改查，以及工具试用控制台 |
| mcpPanel Typert Remote | 服务 | 只读快照通道（主机 → 客户端） |

资源与提示词

资源确实已向上游桥接：基础包挂载 @deepseek-ai/dsh-mcp-resources，官方客户端将每个连接的资源提供者注册到 ctx.mcpResources，而该包拥有三个共享工具（list_mcp_resources、list_mcp_resource_templates、read_mcp_resource）。控制台对服务和已注册工具进行功能检测，并在每个服务器卡片上提供只读的“资源”浏览器（列表 / 模板 / URI 读取）——每次调用都经过官方工具流水线，结果绝不会进入模型上下文。

MCP 提示词模板和资源订阅仍在上游推迟处理；能力看板将“提示词”标记为等待上游支持。

权限与数据

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

安全边界

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

已知限制

- 提示词模板与资源订阅等待上游支持——官方客户端桥接了工具和资源，但没有桥接提示词或订阅。
- 退出码 / stderr 尾部在客户端暴露它们之前，被标记为等待上游支持*。
- 只读面板——控制台绝不伪造连接状态；不可观测的字段读取为 unknown / -1 / —。
- 写入经过验证，而非保证——控制台根据加载器重新应用后的状态重新验证每次写入，并在加载器未应用时如实失败（例如由 $DSH_HOME/cordis.patch.yml 插入的行，profile 层补丁无法触及）。

开发

bash
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 标签（从不推送）。

主题

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

贡献者

- @PerryLink — 创建者与维护者。
- @xiaoyuyu6420 — 诊断出导致干净检出构建失败的缺失客户端 devDependencies（PR #5）。
- @feiler0 — 贡献了 stdio MCP 服务器探针（通过 stdin/stdout 进行一次 MCP 初始化握手）（PR #7，作为 PR #15 合并）。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也会：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认失败关闭 | |
| dsh-background-agents | 持久化的后台子代理，带 Web UI 侧边栏、消息传递与中断 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排与延迟集于一个面板。 | |
| dsh-checkpoint-rewind | 等同于 Claude Code /rewind：快照、会话分叉、一次性恢复 | |
| dsh-claude-move | 将 Claude Code 会话、记忆、技能与 CLAUDE.md 迁移到 DSH | |
| dsh-click | DeepSeek Harness 的跨平台原生桌面控制——Windows 优先。 | |
| dsh-composer-history | Web 输入框的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 数据集质量检查与引用交叉核对（此处消费的可选数值桥接） | |
| dsh-defend | DeepSeek Harness 的提示注入、越狱与密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对手审查 | |
| dsh-draw | DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | DeepSeek Harness 的只读性能诊断。 | |
| dsh-fund-research | 面向中国公募基金的确定性研究报告 | |
| dsh-github | 面向 DSH 的 GitHub PR/issue 集成，每次写入均需审批 | |
| dsh-industry-research | 行业研究编排，通过本插件的 ctx.researchReport.assemble 封存其交付物 | |
| dsh-library | 面向 DeepSeek Harness 的本地文档知识库。 | |
| dsh-local-ai | 面向 DeepSeek Harness 的本地模型（Ollama）集成。 | |
| dsh-lsp-actions | 基于语言服务器的 LSP 诊断、格式化、补全、代码操作与重命名 | |
| dsh-mask | PII 脱敏中间件：在模型边界匿名化，在展示层还原 | |
| dsh-memento | 审批门控的跨会话记忆：ctx.memory 接缝 + SQLite + memory 工具 | |
| dsh-observe | 面向 DeepSeek Harness 的 OpenTelemetry 与 Langfuse 可观测性导出器。 | |
| dsh-output-styles | 与 Claude Code outputStyles 等效的运行时样式切换 | |
| dsh-permission-rules | Claude Code 风格的声明式 allow/deny/ask 权限规则，带审计 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（框架版） | |
| dsh-plugin-guide | 以按需智能体技能形式提供的插件开发知识库 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-reach | 多渠道审批/提问桥接：微信/Telegram/飞书，会话控制台 | |
| dsh-research-report | 可验证的研究报告引擎：内容寻址的证据账本与封存版本 | |
| dsh-score | 面向 DeepSeek Harness 插件的多维质量评分。 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话，并保持持久排序 | |
| dsh-session-sync | 面向 DeepSeek Harness 的跨设备会话同步——你的会话存储的专用 git 镜像。 | |
| dsh-skill-pack-security | 安全审计技能包：密钥扫描、依赖与供应链审查 | |
| dsh-talk | DeepSeek Harness 的语音优先会话循环：与它对话，听它回答。 | |
| dsh-test-drive | 面向 DeepSeek Harness 插件的隔离式安装与冒烟测试试驾。 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板 + 11 个工具 |
| dsh-translate | 面向 DeepSeek Harness 的厂商参数转换与确定性 JSON 修复。 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人）：文本/图片/文件/语音，在聊天中审批 |
| dsh-autotier | 自动的强/廉价模型层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-catalog | PerryLink 系列的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，暴露认证注册表：等级、快照和五维证据 | |
| dsh-kit | 一条命令即可安装核心系列的新手启动包 | |
| dsh-plugin-certification | 社区认证注册表，带可复现检查的等级和徽章 | |
| dsh-plugin-kit | 面向 PerryLink DSH 插件的共享零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件系列渲染为一个页面 | |
| dsh-plugin-upgrade-015 | 合并的 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片，外加零依赖接缝扫描器 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时线 | |

从 DSH Desktop Market 安装

所有 PerryLink 插件均可在内置的 DSH Desktop Market 中浏览：Market → Sources → add source → paste https://perrylink-dsh-catalog.perrylink.workers.dev/catalog-source.json → select it。安装仍会经过 Market 的 npm 身份验证和你的确认。

许可证

Apache License 2.0 © 2026 dsh-mcp-panel 贡献者