dsh-small-mcp-server
Manifest validMCP server manager in the DSH settings panel: lists, adds, edits, removes and enables or disables the mcp-client loader entries, with each in-flight phase shown separately and unsaved drafts never com
dsh-small-mcp-server
English | 中文
DSH web plugin: manage MCP servers from the settings panel. View, edit, remove,
enable, and disable MCP servers. Toggling a server applies on the spot — one
click, no Save. Add / edit / remove are staged and hot-reload on Save. Either
way nothing restarts the process, because each server is a live
@deepseek-ai/dsh-mcp-client loader entry.
DSH 0.2 only (
>=0.2.1-rc.1 <0.3.0-0; verified on0.2.2-rc.3). See PORTING.md for the incompatibilities the older 0.1.x code had to fix in order to load on 0.2, and the 0.2.2-rc.3 adaptation.
Author: liujianqiao701 (github.com/liujianqiao701). Based on an anonymous MIT-licensed v0.1.x upstream; this fork ported it to DSH 0.2 and reworked the settings page. Attribution is kept in LICENSE and PORTING.md.
What this fork changes
Ported to DSH 0.2 and then reworked, so it is not a drop-in copy of upstream:
- Toggling no longer commits your other drafts.
mcp/saveis a whole-table reconcile, and upstream sent the entire draft table on every toggle — so clicking one switch silently saved every other pending edit. A toggle now submits the saved table plus that one flipped row, and leaves every other draft untouched. - Each in-flight phase has its own badge.
pending,loadingandunloadingused to collapse into one "Loading" label, which made a queued row and a tearing-down row look identical to a starting one. - Unsaved rows say so. A row that differs from what is on disk shows an "Unsaved" badge instead of a blank slot.
- Editing an unsaved row keeps its content. Opening a newly added, not-yet-saved server for editing used to fall back to a blank "new server" form and drop what you had typed; it now edits the draft row.
- The hot-reload window is explained. Save shows what is happening during the
1–4 s restart instead of appearing frozen, and a partial failure says that
earlier entries may already be live (
saveis reconcile, not a transaction).
What it does
- View — lists every configured MCP server with its
serverName, transport (stdio / Streamable HTTP), command or URL, and live state (enabled / disabled, plus the connection phase:active,failed,loading, …). - Add / Edit — full editor for a server:
serverName, transport,commandargs+cwd+env(stdio), orurl+headers(HTTP), plus the per-call timeout and thefailOnStartupErrorflag.
- Remove — deletes the server's loader entry (with a confirm prompt).
- Enable / Disable — toggles the entry's
disabledflag without touching its config, so a disabled server keeps its full configuration. Applies immediately on click (it callsmcp/savefor you) — no Save step. - Save → hot reload — add / edit / remove are staged locally; Save reconciles the
loader tree (
create/update/remove), then writes the server set back to the profile'scordis.patch.yml(the durable patch layer). Each operation restarts only the affecteddsh-mcp-clientinstance, which is the same hot-swap the harness HMR performs.
Architecture
A dual-face npm package installed into the web profile:
| Half | Entry | Role |
|---|---|---|
| Server | lib/index.js | Cordis plugin (inject: ["loader"]): mounts the ctx.mcp typert service that projects and reconciles the loader's @deepseek-ai/dsh-mcp-client entries. |
| Protocol | lib/typert.js | Host TYPERT face (mcp/list, mcp/save), auto-registered by dsh-typert-loader. |
| Browser | lib/client.js | React page mounted into the settings.section slot; calls the host through the installed remote.mcp namespace. |
The client↔server channel is the DSH typert protocol: strict zod codecs validate every argument and result on both sides.
Install
dsh plugin --profile web add dsh-small-mcp-server
How it maps to cordis.patch.yml
The plugin manages the dsh-mcp-client rows in the profile's cordis.patch.yml
(the user patch layer — not cordis.yml, which the launcher resets to an
empty list on every boot). A stdio server is the same as:
# cordis.patch.yml
- insert:
- id: mcp-github
name: "@deepseek-ai/dsh-mcp-client"
config:
serverName: github
transport: stdio
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_TOKEN: ...
and a Streamable HTTP server is the same as:
# cordis.patch.yml
- insert:
- id: mcp-web
name: "@deepseek-ai/dsh-mcp-client"
config:
serverName: web
transport: streamable-http
url: http://localhost:3000/mcp
headers:
Authorization: ...
The tool names the model sees stay server-qualified (mcp__<serverName>__<tool>),
exactly as with hand-written entries.
Development
This package ships built output only — the original TypeScript sources,
tsconfig and bundler config were never part of the published npm tarball, so
there is no build step here. Edit lib/*.js directly (it is unminified and
comment-preserving). To check a change:
npm install --legacy-peer-deps --no-package-lock # zod + js-yaml
node --check lib/index.js
Runtime deps (zod, js-yaml) are declared in dependencies rather than
peerDependencies: DSH profiles run with autoInstallPeers: false, so a peer
would not be installed and the host half would fail to import.
Known limitations
reconnectis not surfaced by the editor. A disabled/enabled toggle and edits to other servers keep the storedreconnectblock; the editor itself cannot view or change it.- Advanced
reconnectfields and future MCP capabilities (resources, prompts) are out of scope for this panel; they remain configurable directly incordis.patch.yml. - Save is a reconcile, not a transaction. Operations apply sequentially; if a later entry fails (e.g. the server process can't start), earlier operations are already applied and the failure is reported in the panel.
Comments
Loading…
Similar plugins
by whiteS18
MCP server management panel in Settings: add, edit, enable/disable and delete servers across user and workspace scopes with form or JSON editing, and auto-register discovered MCP tools as native conve
★ 0
MIT
JavaScript
Oct 8, 2026
dsh plugin --profile web add dsh-mcp-servers-panelby Zenjibad
Enables or disables MCP servers from Settings → MCP Servers: stops or starts each @deepseek-ai/dsh-mcp-client connection immediately and persists the change across restarts.
★ 2
MIT
TypeScript
Nov 3, 2026
dsh plugin --profile web add dsh-mcp-toggleby appthin
MCP management page in DSH Settings: list, enable/disable, restart and delete MCP servers, edit them in form or JSON mode, expand a server to see the tools it registers, and paste-import MCP configs f
★ 28
↓ 1.1k/wk
MIT
JavaScript
Nov 11, 2026
dsh plugin --profile web add dsh-mcp-manager-plusby lyufeng000
DSH MCP 服务器管理器:在「设置 → MCP 服务器」里添加、编辑、启停、重连、移除 MCP 客户端条目。
★ 0
MIT
JavaScript
Oct 17, 2026
dsh plugin --profile web add dsh-mcp-managerManage DSH MCP servers from the web settings panel: list, add, edit, remove, enable/disable with live status.
★ 0
MIT
JavaScript
dsh plugin --profile web add @local/mcp-managerby EricXu20266
DSH MCP manager — add/edit/enable/disable MCP server configs, bundled node resolution
★ 0
TypeScript
Aug 18, 2026
dsh plugin --profile web add dsh-mcpmanager