@royenheart/dsh-plugin-mcp-support
A thin, non-duplicating wrapper over the native dsh MCP bridge
@deepseek-ai/dsh-mcp-client.
It makes MCP servers configurable through two layered sources:
- Composition config — the plugin entry's
servers list.
- Persisted dsh settings — the
mcp-support settings namespace.
The wrapper mounts one native mcp-client child fiber per effective server and
re-syncs the mounted set whenever the settings section changes. It does not
vendor or re-implement any connection, tool-discovery, or reconnect logic.
Layout
src/index.ts # host plugin: settings registration + dynamic child mounts + status route
src/client/index.ts # browser half: "mcp" view tab (status page)
src/core/config.ts # pure normalize/merge helpers (no cordis imports)
src/core/status.ts # pure status-row shaping helper
tests/ # node:test suite using a real cordis Context
lib/ # built host + client entries (npm run build)
Web status view
The client half registers an mcp tab in the session header's view-tab row,
immediately to the right of the 轨迹 (trajectory) tab and before any later
tabs such as 技能. Selecting it fetches
/plugins/@royenheart/dsh-plugin-mcp-support/status and shows each effective
MCP server with its transport, mounted state, and the last mount error when
present. No servers configured renders "No MCP servers configured."
Install into a profile
lib/ is generated locally and is not committed. install.py always builds
the repository's own toolchain first (npm install when the toolchain is
missing, then npm run build) and only reports an error when npm itself is
missing.
Install/uninstall idempotently with the bundled script (stdlib-only Python).
The package ships its own cordis.patch.yml (id mcp-support) and declares
dsh.bundle.patch, so the script only links the package into the profile
node_modules, adds the link: dependency, and appends the package to
dsh.profile.bundles. The profile's own cordis.patch.yml is never modified:
python3 install.py install --profile web # install
python3 install.py uninstall --profile web # remove
python3 install.py install --profile web --home "$DSH_HOME" # explicit home
Manual alternative:
dsh plugin --profile <profile-name> add link:/home/royenheart/projects/dsh-plugins/dsh-plugin-mcp-support
dsh plugin reconciles dsh.profile.bundles from the installed package's
dsh.bundle declaration, so no profile patch edit is needed either.
Restart dsh. The plugin declares inject: ['settings', 'tools'], so it loads
once both the dsh settings service and the native tool registry are available.
Composition config example
Configure the bundle-inserted row by id in the profile's own
cordis.patch.yml (the bundle patch already inserts the row; this patch only
overrides its config):
- id: mcp-support
config:
servers:
- transport: stdio
serverName: filesystem
command: npx
args:
- -y
- '@modelcontextprotocol/server-filesystem'
- /tmp
env: {}
cwd: ''
toolCallTimeoutMs: 60000
failOnStartupError: false
- transport: streamable-http
serverName: everything
url: http://localhost:3000/mcp
headers:
Authorization: Bearer secret
toolCallTimeoutMs: 60000
failOnStartupError: false
Settings example
Persisted settings are layered over the composition list. Servers are keyed
by serverName: a settings server with the same name overrides the composition
entry; settings-only servers are appended after composition servers.
The namespace is mcp-support. (If settings.yaml still carries the key from
an earlier misspelled build, rename that key to mcp-support once.)
In the profile's settings document (settings.yaml):
mcp-support:
servers:
- transport: stdio
serverName: filesystem
command: npx
args:
- -y
- '@modelcontextprotocol/server-filesystem'
- /tmp
- transport: streamable-http
serverName: everything
url: http://localhost:3000/mcp
headers:
Authorization: Bearer secret
Config reference
Each servers entry is exactly the native @deepseek-ai/dsh-mcp-client config
union.
stdio
| Field | Required | Default | Notes |
|---|
transport | yes | — | stdio |
serverName | yes | — | [A-Za-z0-9_-]{1,32}, unique per source list |
command | yes | — | executable to spawn |
args | no | [] | passed without shell interpolation |
env | no | {} | merged over the scrubbed ambient env |
cwd | no | '' | child working directory |
toolCallTimeoutMs | no | 60000 | per-tool-call timeout |
failOnStartupError | no | false | reject plugin activation on initial connection failure |
reconnect | no | native defaults | enabled, initialDelayMs, maxDelayMs, maxAttempts |
streamable-http
| Field | Required | Default | Notes |
|---|
transport | yes | — | streamable-http |
serverName | yes | — | [A-Za-z0-9_-]{1,32}, unique per source list |
url | yes | — | MCP endpoint URL |
headers | no | {} | extra request headers |
toolCallTimeoutMs | no | 60000 | per-tool-call timeout |
failOnStartupError | no | false | reject plugin activation on initial connection failure |
reconnect | no | native defaults | enabled, initialDelayMs, maxDelayMs, maxAttempts |
Develop
npm run typecheck
npm run build
npm test
