Skip to content
Back to search

dsh-small-mcp-server

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…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/liujianqiao701--dsh-small-mcp-server/badge.svg)](/listings/liujianqiao701--dsh-small-mcp-server)

HTML

<a href="/listings/liujianqiao701--dsh-small-mcp-server"><img src="/api/listings/liujianqiao701--dsh-small-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

dsh plugin --profile web add dsh-small-mcp-server

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 142 lines
  1. # dsh-small-mcp-server
  2. English | [中文](README.zh.md)
  3. DSH web plugin: **manage MCP servers from the settings panel**. View, edit, remove,
  4. enable, and disable MCP servers. **Toggling a server applies on the spot** — one
  5. click, no Save. Add / edit / remove are staged and hot-reload on **Save**. Either
  6. way nothing restarts the process, because each server is a live
  7. `@deepseek-ai/dsh-mcp-client` loader entry.
  8. > **DSH 0.2 only** (`>=0.2.1-rc.1 <0.3.0-0`; verified on `0.2.2-rc.3`).
  9. > See [PORTING.md](./PORTING.md) for the incompatibilities the older 0.1.x code
  10. > had to fix in order to load on 0.2, and the 0.2.2-rc.3 adaptation.
  11. > **Author:** liujianqiao701 ([github.com/liujianqiao701](https://github.com/liujianqiao701)).
  12. > Based on an anonymous MIT-licensed v0.1.x upstream; this fork ported it to DSH 0.2
  13. > and reworked the settings page. Attribution is kept in [LICENSE](./LICENSE) and
  14. > [PORTING.md](./PORTING.md).
  15. ## What this fork changes
  16. Ported to DSH 0.2 and then reworked, so it is not a drop-in copy of upstream:
  17. - **Toggling no longer commits your other drafts.** `mcp/save` is a whole-table
  18. reconcile, and upstream sent the entire draft table on every toggle — so
  19. clicking one switch silently saved every other pending edit. A toggle now
  20. submits the saved table plus that one flipped row, and leaves every other
  21. draft untouched.
  22. - **Each in-flight phase has its own badge.** `pending`, `loading` and
  23. `unloading` used to collapse into one "Loading" label, which made a queued row
  24. and a tearing-down row look identical to a starting one.
  25. - **Unsaved rows say so.** A row that differs from what is on disk shows an
  26. "Unsaved" badge instead of a blank slot.
  27. - **Editing an unsaved row keeps its content.** Opening a newly added, not-yet-saved
  28. server for editing used to fall back to a blank "new server" form and drop what
  29. you had typed; it now edits the draft row.
  30. - **The hot-reload window is explained.** Save shows what is happening during the
  31. 1–4 s restart instead of appearing frozen, and a partial failure says that
  32. earlier entries may already be live (`save` is reconcile, not a transaction).
  33. ## What it does
  34. - **View** — lists every configured MCP server with its `serverName`, transport
  35. (stdio / Streamable HTTP), command or URL, and live state (enabled / disabled,
  36. plus the connection phase: `active`, `failed`, `loading`, …).
  37. - **Add / Edit** — full editor for a server: `serverName`, transport, `command`
  38. - `args` + `cwd` + `env` (stdio), or `url` + `headers` (HTTP), plus the
  39. per-call timeout and the `failOnStartupError` flag.
  40. - **Remove** — deletes the server's loader entry (with a confirm prompt).
  41. - **Enable / Disable** — toggles the entry's `disabled` flag without touching
  42. its config, so a disabled server keeps its full configuration. **Applies
  43. immediately on click** (it calls `mcp/save` for you) — no **Save** step.
  44. - **Save → hot reload** — add / edit / remove are staged locally; **Save** reconciles the
  45. loader tree (`create` / `update` / `remove`), then writes the server set back
  46. to the profile's `cordis.patch.yml` (the durable patch layer). Each operation
  47. restarts only the affected `dsh-mcp-client` instance, which is the same
  48. hot-swap the harness HMR performs.
  49. ## Architecture
  50. A dual-face npm package installed into the `web` profile:
  51. | Half | Entry | Role |
  52. | -------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
  53. | 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. |
  54. | Protocol | `lib/typert.js` | Host TYPERT face (`mcp/list`, `mcp/save`), auto-registered by `dsh-typert-loader`. |
  55. | Browser | `lib/client.js` | React page mounted into the `settings.section` slot; calls the host through the installed `remote.mcp` namespace. |
  56. The client↔server channel is the DSH typert protocol: strict zod codecs validate
  57. every argument and result on both sides.
  58. ## Install
  59. ```sh
  60. dsh plugin --profile web add dsh-small-mcp-server
  61. ```
  62. ## How it maps to `cordis.patch.yml`
  63. The plugin manages the `dsh-mcp-client` rows in the profile's `cordis.patch.yml`
  64. (the user patch layer — **not** `cordis.yml`, which the launcher resets to an
  65. empty list on every boot). A stdio server is the same as:
  66. ```yaml
  67. # cordis.patch.yml
  68. - insert:
  69. - id: mcp-github
  70. name: "@deepseek-ai/dsh-mcp-client"
  71. config:
  72. serverName: github
  73. transport: stdio
  74. command: npx
  75. args: ["-y", "@modelcontextprotocol/server-github"]
  76. env:
  77. GITHUB_TOKEN: ...
  78. ```
  79. and a Streamable HTTP server is the same as:
  80. ```yaml
  81. # cordis.patch.yml
  82. - insert:
  83. - id: mcp-web
  84. name: "@deepseek-ai/dsh-mcp-client"
  85. config:
  86. serverName: web
  87. transport: streamable-http
  88. url: http://localhost:3000/mcp
  89. headers:
  90. Authorization: ...
  91. ```
  92. The tool names the model sees stay server-qualified (`mcp__<serverName>__<tool>`),
  93. exactly as with hand-written entries.
  94. ## Development
  95. This package ships **built output only** — the original TypeScript sources,
  96. `tsconfig` and bundler config were never part of the published npm tarball, so
  97. there is no build step here. Edit `lib/*.js` directly (it is unminified and
  98. comment-preserving). To check a change:
  99. ```sh
  100. npm install --legacy-peer-deps --no-package-lock # zod + js-yaml
  101. node --check lib/index.js
  102. ```
  103. Runtime deps (`zod`, `js-yaml`) are declared in `dependencies` rather than
  104. `peerDependencies`: DSH profiles run with `autoInstallPeers: false`, so a peer
  105. would not be installed and the host half would fail to import.
  106. ## Known limitations
  107. - **`reconnect` is not surfaced by the editor.** A disabled/enabled toggle and
  108. edits to other servers keep the stored `reconnect` block; the editor itself
  109. cannot view or change it.
  110. - **Advanced `reconnect` fields and future MCP capabilities** (resources,
  111. prompts) are out of scope for this panel; they remain configurable directly in
  112. `cordis.patch.yml`.
  113. - **Save is a reconcile, not a transaction.** Operations apply sequentially; if
  114. a later entry fails (e.g. the server process can't start), earlier operations
  115. are already applied and the failure is reported in the panel.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.