dsh-settings-mcp-skills

English | 中文

A DeepSeek Harness bundle plugin that adds the MCP Servers and Skills settings pages to the dsh web UI.

DeepSeek's npm-shipped dsh (npm install -g @deepseek-ai/dsh) ships an older web-app bundle that omits these two settings pages. This plugin backports them into your web profile with one command — you keep every other part of your dsh install untouched.

• MCP Servers page — list, add, edit, and delete external MCP servers. Each row shows a live connection-status slider (connected / disconnected / reconnecting / failed); the add dialog collects transport, server name, and transport-specific fields (command/args/env for stdio, url/headers for HTTP).
• Skills page — drag-and-drop upload of a folder containing SKILL.md. The host writes uploaded skills to $DSH_HOME/skills/<name>/SKILL.md, where the built-in filesystem skill provider auto-discovers them.

The underlying MCP client, skill loader, settings seam, and connection status are all provided by dsh itself — this plugin contributes only the settings UI pages. It does not re-implement or replace any of dsh's MCP or skill mechanisms.

Install

Install into your web profile. This plugin is published to npm, so the simplest path is the package name (no github: needed):

dsh plugin --profile web add dsh-settings-mcp-skills

On install pnpm runs a small postinstall script that ships with the bundle. It does no compilation and reaches no network — it only extracts the two pre-built official packages (bundled as tarballs under deps/) into your profile's node_modules so the settings pages can load.

pnpm (≥10) blocks build scripts (postinstall/prepare) until they are allowlisted — for both npm and git installs. On the first run, pnpm prints the exact package key and the file to edit. Set that key to true under allowBuilds in your profile's $DSH_HOME/profiles/web/pnpm-workspace.yaml, then re-run the same add command. You only do this once.

pnpm 11 release-age gate: for ~10 days after a new version ships, pnpm may silently install an older version instead (e.g. add resolves 0.1.0 while latest is 0.1.1). If dsh plugin ... add reports +1 but you do not see postinstall run (or the settings pages still do not appear), add the version to your profile's pnpm-workspace.yaml and re-add:

minimumReleaseAgeExclude:
  - dsh-settings-mcp-skills@0.1.1

Then dsh plugin --profile web add dsh-settings-mcp-skills@0.1.1.

Once installed, boot and the two new pages appear under Settings:

dsh --profile web

To uninstall:

dsh plugin --profile web remove dsh-settings-mcp-skills

Pin a version for repeatability: dsh-settings-mcp-skills@0.1.0.

You can also install from the GitHub repository or a local clone/tarball:

dsh plugin --profile web add github:w123456789zy/dsh-settings-mcp-skills
dsh plugin --profile web add ./dsh-settings-mcp-skills
# or
dsh plugin --profile web add ./dsh-settings-mcp-skills-0.1.0.tgz

The allowBuilds step applies to these too (pnpm gates postinstall regardless of source). Pin a git commit for repeatability: github:w123456789zy/dsh-settings-mcp-skills#<sha>.

What it installs

The bundle inserts two plugin rows into the web profile and ships the two packages they reference, so they resolve locally without needing npm:

Row id	Package	Role
ui-settings-tools	@deepseek-ai/dsh-client-ui-settings-tools	Browser settings pages (MCP + Skills), registered as settings.section slots
host-tool-settings	@deepseek-ai/dsh-host-tool-settings	Host service owning mcp-servers / skill-sources namespaces + disk projection

The cordis.patch.yml layer is applied after web-app, so it only adds rows that the npm-shipped web-app leaves out and never overrides your own profile or home-level cordis.patch.yml.

License and attribution

This bundle itself is MIT. It re-distributes two DeepSeek Harness packages (@deepseek-ai/dsh-client-ui-settings-tools and @deepseek-ai/dsh-host-tool-settings), which are DeepSeek components licensed MIT, Copyright (c) 2026 DeepSeek. They ship as bundled tarballs under deps/, and each tarball carries its own unchanged MIT LICENSE. THIRD_PARTY_NOTICES.md records the attribution. This re-distribution is permitted by their MIT license.

Building / packaging

No build step is needed for users — the dependencies ship pre-built. To package your own tarball before publishing:

pnpm pack