DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

2026heshao /

2026heshao/dsh-skill-mcp-board

Verified

All-in-one board for DeepSeek Harness: MCP manager + Skills + tool-usage tailor + direct markets (WorkBuddy connectors, SkillHub 190k+ skills) with one-click install · DSH 一体化看板:MCP/技能/工具账本/三大市场直连安装

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHubProject homepage
READMESource: main@bd3b8aa8

dsh-skill-mcp-board — 军械库 / Armory

中文 | English

DeepSeek Harness 的一体化管理看板:MCP 服务器 · 技能 · 工具使用账本 · 三大市场(WorkBuddy 连接器 316 个 / 内置精选 47 个 / SkillHub 技能 19 万+),浏览、搜索、一键安装。 本项目 fork 并改写自 Imzl-zl/dsh-mcp-manager-ui(MIT), 从纯 MCP 管理面板升级为 MCP + 技能 + 市场 + 工具账本 四合一看板。

stars release license DSH topic: dsh-plugin

一键安装

dsh plugin --profile web add github:2026heshao/dsh-skill-mcp-board

装完重启 DSH,侧栏顶部「全局面板」里点 技能 · MCP(或右下角悬浮按钮)。桌面端装在 desktop profile 时把 --profile web 换成 --profile desktop。

它解决什么

痛点 本插件的做法
MCP 配置要手改 YAML,改完不知道连没连上 可视化面板:状态、工具 Schema、启停、重连,全局与项目双作用域,项目级改完即对存活会话生效
装技能要去各处翻 SKILL.md 仓库 市场直连:SkillHub 19 万+ 技能、WorkBuddy 316 个连接器、47 个一手核实的内置服务,搜索/筛选/一键安装,逐文件 sha256 校验
每个 MCP 的工具描述都在吃上下文 token,零调用的工具白白占位 工具裁缝:扫描本机会话日志统计每个工具的调用/错误/延迟,死工具清单一键禁用
从 Claude/Cursor/VS Code 迁移要逐条抄配置 自动检出 11 种客户端的本机配置,预览后一键导入

界面预览

全局管理面板

MCP 管理面板

项目作用域(.dsh/mcp.json)

项目 MCP

连接详情与新增

MCP 连接详情

新增 MCP

功能

  • 查看每个 MCP 的状态、传输方式、连接参数与工具列表;展开工具可看完整输入 JSON Schema(必填/可选、类型、枚举、默认值与原始 JSON)
  • 按传输方式(HTTP/stdio)与状态筛选,按名称/命令/URL 搜索
  • 启用、禁用、重连、添加、编辑、移除;需要时用眼睛临时揭示被掩码的凭据并一键复制
  • 全局 + 项目双作用域:全局写 Web profile,一次注册所有项目可用;项目写该项目 .dsh/mcp.json,只该项目会话可见;项目里还能「屏蔽」某个全局 MCP
  • 两个入口,同一个面板:右下角悬浮按钮(可拖拽、记忆位置)与官方侧栏入口(展开态在「设置」上方显示「MCP」,收起成 56px 轨道时只剩图标)共享同一开关状态;面板右上角「入口」可以把两者只留一个(不能都关)
  • MCP 市场:47 个逐条一手核实过的服务,分 10 类(搜索、开发工具、安全与逆向、数据库与数据、AI 与知识、浏览器自动化、云与基础设施、效率协作、文件与本地、通讯)。搜索为主操作,配分类与「只要免密钥」筛选、排序、卡片直接安装;每条如实标注免费额度与需要准备什么(密钥 / 连接信息 / 装完还得改的参数)。已配置的只识别并跳过,不覆盖
  • 导入本机其他客户端的 MCP 配置:自动检测 Claude Code、Codex(config.toml)、OpenCode(含 .jsonc)、pi、Claude Desktop、Cursor、Windsurf、VS Code、Gemini CLI、Roo Code 与跨工具的共享配置,逐个列出,点一条即导入;也能粘贴 Claude/Cursor/Cline/Roo 的 mcpServers 或 VS Code 的 servers JSON。写入前预览,支持「合并(同名更新)」与「替换」
  • 跟随 DSH 深色/浅色主题,适配窄屏与移动宽度
  • 更新提示与一键升级:有新版时在面板顶部显示可关闭的提示条(每天最多查一次,可用 DSH_MCP_MANAGER_DISABLE_UPDATE_CHECK 关闭)。点了「升级」才动,不会自动升级;升级由 DSH 官方的 pluginManager 执行,装完提示重启宿主生效。用 link: / file: / github: 装的本地开发副本不给按钮(那会把链接换成 npm 包)
  • 升级后主动说一次变了什么:版本变了后第一次打开面板弹一张小卡片,列出本次更新内容,并指路新功能在哪(例如「入口」开关在面板右上角);确认一次后不再提示,不联网、不发任何数据
  • 工具裁缝(1.7.0 新增):扫描本机会话日志(只解析 tool/call / tool/result 两类事件,不读消息正文),统计每个工具近 7/30/90 天的调用次数、错误率与最后使用时间;同时按当前注册表估算每个工具 Schema 每轮请求占用的上下文 token。窗口内零调用的 MCP 工具自动进「死工具清单」,行内可一键禁用/启用对应服务器(复用官方写链,随时可恢复)。全程只读,多帧 zstd 日志逐帧解析、个别帧损坏跳过不中断
  • WB 市场(直连安装,1.8.0 新增):看板第四个分类,两个市场一处浏览——
    • 连接器(MCP):直读 WorkBuddy 官方分发 ZIP(static.workbuddy.cn,与 WorkBuddy 桌面端同一数据源),316 个连接器按需解析;可安装的 242 个(streamable-http 为主),CLI 型 / 需 WorkBuddy token 注入的 74 个如实标注「仅展示」并给出原因。安装 = 把该连接器的 mcpServers 合并写入 MCP 配置,与「导入 JSON」同一链路(准入、同名跳过、entry id 预留一致),全局与项目作用域都可选;ZIP 按 ETag 缓存在 ~/.dsh/wb-market/,解压用 Node 内置 zlib,零新增运行时依赖
    • 技能(SkillHub):直读 SkillHub 公开 API(api.skillhub.cn,19 万+ 技能),支持搜索(keyword)、排序(下载/安装/星标/评分)、分页;详情含发布方认证与安全扫描状态。安装 = 逐文件下载并按清单 sha256 校验后写入 ~/.agents/skills/(与官方 skill 子系统同一发现范围),装完即刻生效;已装的显示「已安装」,可一键卸载、重装即更新
    • 技能版权归原作者所有;两个均为第三方接口,字段可能随上游改版变化(面板顶部有常驻说明)

安装

dsh plugin --profile web add github:2026heshao/dsh-skill-mcp-board

装完重启 dsh web(桌面端把 --profile web 换成 --profile desktop)。升级:换新版 tag 重新 add,或在面板「一键升级」提示条上直接点。卸载(不会删除 profile 里已有的 MCP 条目):

dsh plugin --profile web remove dsh-skill-mcp-board

细节、本地开发安装与故障排查见 安装与升级。

不要把 mcp-manager-ui 手工插进 profile 的 cordis.patch.yml、Agent preset 或额外的 --patch 文件——插件命令已经完成这件事,重复装配会明确报错。

使用

打开面板

两个入口,同一个面板:

  • 右下角悬浮按钮:可拖拽移动,位置会被记住;
  • 侧栏底部「MCP」:展开态在「设置」上方,侧栏收起成 56px 轨道时只剩图标。

面板浮在会话之上,关掉它(右上角「关闭」或 Esc)不会影响会话。

两个入口都能单独关掉:面板右上角「入口」里选 悬浮按钮 + 侧栏入口(默认)/ 仅悬浮按钮 / 仅侧栏入口。不能两个都关——面板只能从这两个入口打开,所以这是一个三选一,而不是两个独立的开关。选择存在浏览器本地(localStorage),换浏览器或清缓存要重选一次。

全局 vs 项目

顶部标签页在「全局」与各项目之间切换:

标签页 存哪 谁可见 改动何时生效
全局 Web profile 的 cordis.patch.yml 所有项目 DSH 热加载,通常立即生效
某项目 该项目 .dsh/mcp.json 只该项目会话 写盘即生效(见下)

serverName 按作用域判重:不同项目之间、全局与项目之间可以同名,各自独立连接;同一作用域内不能重名。

常用操作

在列表行或详情页里:

  • 开关:启用 / 禁用(全局写 profile 补丁的 disabled,项目写 .dsh/mcp.json);
  • 重连:全局条目重载 loader 条目;项目连接会拆掉旧连接、按当前配置重建并重新投射给存活会话(mcp-client 的重连预算耗尽后必须靠它恢复);
  • 编辑 / 移除:移除只影响当前作用域;
  • 屏蔽(项目页里对全局 MCP):写 exclude,该项目的新会话不再看到它——全局实例仍在跑,所以不影响其他项目。

添加 MCP

三条路,都从面板顶部工具栏进:

  1. 添加 MCP:表单填 command/args/env/cwd(stdio)或 url/headers(HTTP),可设调用超时、启动失败策略与重连策略;常用服务器有预设模板可一键套用。
  2. 导入 JSON:粘贴其他客户端的配置,先预览再写入。支持「合并(同名更新)」与「替换」,字段映射与限制见 JSON 导入。
  3. 内置 MCP:勾选未配置的项一次装好(Exa、Tavily、Firecrawl、Chrome DevTools、Playwright)。前三项有免密额度、不需要本地依赖;后两项是本地工具,需要 Node.js 与浏览器。已配置的项只识别并跳过,不会覆盖。

看工具与敏感值

详情页列出该 MCP 当前注册的工具;展开可看完整输入 Schema。凭据类字段默认掩码,点眼睛图标会向 Host 读取有效运行值(已解析过的环境变量)并临时显示,再点一次恢复;已显示的值可一键复制。编辑时若没实际改动输入,保存仍保留原来的引用写法,不会把密钥写回配置文件。

配置生效时机(重要)

作用域 修改后何时生效
全局 DSH 热加载,通常立即生效(含运行中的会话)
项目 写盘即生效:新增立刻挂上存活会话、删除立刻撤掉工具、改动就地重载连接(工具名不变)

项目 MCP 由本项目所有会话共用一份连接,配置写在 .dsh/mcp.json。面板保存的那一刻就会对齐到正在运行的会话,不需要重开会话,也不需要重启 Host;手工编辑该文件则在下一次会话挂载时被采纳。

连接跟配置走,不跟会话走:最后一个会话结束不会拆掉连接,它只进入空闲等待,下一次会话直接复用——这样"要用的时候"它已经就绪(这也是宿主自己的契约:工具必须在首轮之前出现)。两个旋钮写在 server 条目里:idleTimeoutMs(空闲保留多久,默认 5 分钟,0 = 永不回收)与 readyTimeoutMs(挂载时等就绪的总预算,默认 5s,0 = 不等)。字段速查与边界见 设计与限制。

状态怎么看:项目行把两件独立的事分开说,不合成一个状态。

  • 连接在不在:已连接 · 当前无会话使用(连接保留,下次直接用) / 已连接 · N 个会话在用 / 连接中… / 连接失败 / 尚未建立连接(新会话自动挂载)。
  • 几个会话在用:见上一行的 N 个会话在用;不再出现「待会话挂载」那种把两者压成一句、容易被读成"还没连上"的写法。

重连是必需出口:mcp-client 的自动重连有次数上限,耗尽后它会注销工具并停止,只能靠重载配置或重启宿主恢复(它的 README 明写)。项目 MCP 又不是常驻服务,所以面板的「重连」按钮会拆掉旧连接、按当前配置重建,并重新投射给存活会话。

常见问题

面板里显示「已禁用」,但模型调用报 unknown tool "mcp__xxx__..." 那个 MCP 被禁用了,所以它没有注册任何工具。在面板里点「启用」即可(全局会写 profile 补丁并热加载,项目写 .dsh/mcp.json、写盘即生效)。

那一行显示「挂载失败」「连接失败」或「作用域隔离失败」,怎么区分? 三类是不同的事,详情页会给出具体原因:挂载失败 = 会话挂载阶段(agent/created 监听器)就没挂上(变量求值为空、failOnStartupError 下启动失败、工具注册被拒);连接失败 = mcp-client 连不上或重连耗尽(原因取自它的日志);作用域隔离失败 = 连接正常但工具不在共享作用域层(宿主里出现了两份 @deepseek-ai/dsh-scope)。排查与原理见 设计与限制。

项目行那些状态文案分别是什么意思? 它们把两件独立的事分开说:连接在不在 —— 已连接 · 当前无会话使用(连接保留,下次直接用)(最后一个会话结束了,连接按空闲策略留着)/ 已连接 · N 个会话在用 · M 工具 / 连接中… / 连接失败 / 尚未建立连接(新会话自动挂载);几个会话在用 —— 就是那句里的 N 个会话在用。旧版本的「待会话挂载」正是把这两件事压成一句,所以容易被读成"还没连上"。

怎么升级?为什么面板没提示? 从 npm 装的直接 dsh plugin --profile web update dsh-mcp-manager-ui 就会升小版本,也可以直接点面板提示条上的「升级」(同一件事,免去敲命令)。面板的提示条只查 GitHub Releases、每天最多一次、可关闭、不会自己动;固定 tag 安装的用户不会自动跨版本,需要用新 tag 重新 add(见 安装与升级)。

改动会不会碰到我的其他配置? 不会。全局改动只动 profile 补丁里由 @deepseek-ai/dsh-mcp-client 声明、且由本插件管理的条目,保留其他插件条目、注释与 !!js 表达式;导入「替换」也只替换这一部分,不会删除其他 bundle 或 Agent preset 自带的 MCP。

卸载后我配置的 MCP 会消失吗? 卸载插件不会删除 profile 里已有的 @deepseek-ai/dsh-mcp-client 条目;项目的 .dsh/mcp.json 也留在原处(它本来就是普通 JSON 文件)。

兼容性

项目 已验证
DeepSeek Harness 0.1.5-rc.1 及以上(已验证至 0.2.0-rc.2)
Node.js DSH 自带/支持的运行时
平台 Windows;Linux/macOS 使用同一 DSH Web 契约

只支持 0.1.5 起(更早的版本缺少「按注册作用域判 serverName 唯一性」与「setup 传入 agent」两个能力),不为旧版本保留降级分支。原因与依赖细节见 设计与限制。

开发

npm test                              # 全部测试(含真机集成用例)
dsh --profile web --dump-config       # 看 profile 的有效配置
dsh web                               # 起 Web 做真实操作验证

npm test 里除替身用例(验证插件内部自洽)外,还有一组真机集成用例:真 cordis + 真 dsh-tools + 真 dsh-scope + 真 dsh-mcp-client + 一个真 stdio MCP 子进程,覆盖「同项目两个会话共用一份连接、工具投射进会话层、不泄漏到全局、子进程随最后一个会话退出」。CI(push 到 main / PR,以及推 tag 发版)跑的是同一条门槛,发版流程见 安装与升级。

文档

  • 安装与升级
  • JSON 导入
  • 设计与限制(共享连接模型、连接状态语义、已知限制、依赖细节)
  • DeepSeek Harness 官方插件发布指南

相关链接

  • LINUX DO(友链)
  • DeepSeek Harness
  • GitHub dsh-plugin 主题

License

MIT

—/ 5

No ratings yet

Verified DSH bundle

Commit bd3b8aa8b33f

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout