@royenheart/dsh-plugin-mcp-support
对原生 @deepseek-ai/dsh-mcp-client 桥接的轻量、不重复的 dsh 封装：由组合和设置驱动的 MCP 服务器挂载。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:royenheart/dsh-plugin-mcp-support#c4eb7dceeddae0c3a3c9813a5e18a1bcc6991333Plugin Mcp Support 以 @royenheart/dsh-plugin-mcp-support 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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:
servers list.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.
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)
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."
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.
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
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
Each servers entry is exactly the native @deepseek-ai/dsh-mcp-client config
union.
| 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 |
| 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 |
npm run typecheck
npm run build
npm test