kairoz9/dsh-mcp-admin 预览 preview

kairoz9/dsh-mcp-admin

dsh 的 MCP 状态检查与服务管理插件

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), designed to help users inspect MCP server status and manage MCP server configurations directly within DSH. It offers two core features: a /mcp command that lists all configured MCP servers across all DSH profiles and displays real-time tool counts for each server, and a dedicated MCP management panel in the DSH settings page. There are three supported installation methods: downloading the pre-built release tarball, building and packing the tarball locally from source, or installing directly from the Git repository, that fits most user needs.

Any DSH user that connects to multiple MCP servers will find this plugin helpful for keeping track of server status and adjusting configurations quickly. When you want to check current MCP status, just type /mcp into DSH's command bar, and you will get a full list of MCP servers across all your DSH profiles along with their respective tool counts. If you need to add, edit, delete, enable, or disable any MCP server, just open the MCP panel in DSH's settings page, make your changes, and the plugin will automatically save changes to cordis.patch.yml and trigger DSH's hot reload.

This plugin is released under the open source MIT license, so it is free to use and modify for any purpose. If you choose to install it from the Git repository directly, note that pnpm version 10 and above blocks the prepare script for git dependencies by default, which will cause the initial installation to fail. To fix this issue, you just need to add an entry allowing the plugin to build in your profile's pnpm-workspace.yaml as instructed in DSH's error message, and then re-run the install command. Building locally also requires pnpm, so it is recommended that most users install from the pre-built release tarball to avoid extra steps.

这是一款专为DeepSeek Harness(DSH)开发的原生插件,用于查看和管理DSH中的MCP(模型上下文协议)服务器。它提供两个核心功能:一是通过/mcp命令列出所有配置文件中的MCP服务器,并展示每个服务器的实时工具数量;二是在设置页面添加专门的MCP管理面板,支持针对每个配置文件添加、编辑、删除、启用、禁用MCP服务器。插件支持三种安装方式:下载官方发布压缩包、本地构建打包、从Git源码仓库安装,可满足不同使用场景需求。

对于DSH用户来说,这款插件可以帮助你直观掌握所有MCP服务器的运行状态,方便快速调整MCP配置。使用时,你可以直接在命令栏输入/mcp,就能看到全部分配置文件下的MCP服务器列表和对应工具数;如果需要修改配置,可以打开设置页的MCP面板,直接操作修改,修改后会自动写入cordis.patch.yml并触发DSH热重载。它适合所有需要在DSH中使用多个MCP服务器、想要便捷管理MCP配置的开发者使用。

本插件采用MIT许可证开源,完全免费使用。使用Git源码安装时需要注意,pnpm ≥10默认会阻止git依赖的prepare脚本运行,导致首次安装失败,按照DSH给出的错误提示,在对应配置文件的pnpm-workspace.yaml中添加允许构建该插件的配置即可解决。本地构建需要依赖pnpm包管理器,推荐用户直接下载官方发布的压缩包安装,省去本地构建的额外步骤。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:kairoz9/dsh-mcp-admin

把 kairoz9/dsh-mcp-admin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-mcp-admin

English | 简体中文

A dsh (DeepSeek Harness) plugin: Inspect MCP status (/mcp command) + Manage MCP servers in Settings (add / edit / delete / enable / disable, written back to cordis.patch.yml). MIT licensed.

/mcp command output:

/mcp command

Settings page "MCP" panel:

Settings MCP Panel

Installation

Release tarball (Recommended, no build required): Download dsh-mcp-admin-<version>.tgz from Releases, then run:

dsh plugin --profile web add ./dsh-mcp-admin-0.2.0.tgz

Build tarball locally (if building yourself):

pnpm run build        # Builds to lib/
pnpm pack             # Packages into tarball
dsh plugin --profile web add ./dsh-mcp-admin-0.2.0.tgz

Git repository (installs from source via prepare build):

dsh plugin --profile web add github:kairoz9/dsh-mcp-admin

pnpm ≥10 refuses to run the prepare script of git dependencies by default, which causes the initial Git installation to fail. dsh will print the fix in the error message: add the package key to that profile's pnpm-workspace.yaml and re-run add:

allowBuilds:
  dsh-mcp-admin: true

It is recommended to pin a commit or tag: github:kairoz9/dsh-mcp-admin#v0.2.0.

Usage

  • /mcp — Lists MCP servers across all profiles + live tool count (including never-connected servers, read from full config inventory).
  • Settings page "MCP" panel — Manage MCP servers per profile: add / edit / disable / enable / delete, with status dots auto-refreshing every second. Saving writes back to that profile's cordis.patch.yml, and dsh automatically hot-reloads (HMR).

How It Works

Host-side McpAdminRemote (TypertRemoteService, @Remote methods) is auto-discovered by the host gateway. The browser client self-mounts this namespace via ctx.remote.$mount, and both the panel and /mcp popup read the same structured data:

  • list() — Reads the full server inventory from the profile's cordis.patch.yml, then filters mcp__ prefix with ctx.tools.schemas() to annotate real-time tool counts; enumerates active mcp-client instances from Cordis registry to distinguish "connected / instance present with 0 tools (connection failed) / not loaded".
  • set() — Reconciles and writes back to cordis.patch.yml (single atomic write, comments preserved), and dsh's watchUserPatches HMR automatically reloads mcp-client.
  • /mcp command reads all profiles and outputs the tool list for each server.
← 上一个 Prev dsh-voice 下一个 Next plugin-switch →