Official DSH plugin for nuphus-mcp (by the nuphus-mcp maintainers): desktop and browser automation (38 tools) with PaddleOCR element perception and Chrome CDP browsing, via a persistent stdio MCP child process.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-nuphus-mcp
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:mrpulor-gh/dsh-nuphus-mcp
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
DSH plugin that mounts nuphus-mcp
as native DSH tools — computer use for your agents. No nuphus-mcp code inside:
a thin Cordis wrapper that spawns the nuphus-mcp binary over stdio via
@deepseek-ai/dsh-mcp-client.
Install
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:mrpulor-gh/dsh-nuphus-mcp
Restart dsh --profile web — activation is automatic (dsh.bundle.patch).
What you get
- Discovers the connected server's tools as
mcp__nuphus-mcp__*; the count and schemas depend on that server build - Auto-installs
nuphus-mcpon first boot if missing onPATH --confirm-writeon by default (write tools need"confirm": true)- Same
NUPHUS_MCP_*env vars as every other client - Keeps one MCP client for the plugin lifetime; tool calls preserve the server's descriptions, arguments and results
Requirements
- DSH
webprofile, Node.js^22.19/>=24 - DSH must run in the desktop session of the controlled machine
Config
Overridable in cordis.yml / patch:
| Field | Default | Description |
|---|---|---|
serverName |
nuphus-mcp |
Tool namespace |
command |
nuphus-mcp |
Executable to spawn |
args |
["--confirm-write"] |
CLI args |
autoInstall |
true |
Install the default command if missing on PATH; set false for managed installations |
toolCallTimeoutMs |
120000 |
Per-call timeout (screenshots/OCR exceed 60000) |
autoInstall must be a boolean. A custom command is always used as supplied,
including paths containing spaces or non-ASCII characters, and never triggers
an automatic install. Windows PATH probes and installer processes are hidden;
the MCP SDK also hides its stdio child process.
Reuse the task page
Use a server build containing nuphus-mcp PR #12
and PR #13, such as
commit 0a689c1.
The published v0.3.3 release predates those changes; a 0.3.3 version string
alone does not establish that the fixes are included. Updating this adapter or
auto-installing an older npm build cannot add the browser behavior by itself.
With that server build:
- Use
mcp__nuphus-mcp__browser_navigatefor ordinary navigation. It reuses the selected task page, including the startup page, instead of opening another tab. - To use another existing tab or a site popup, list tabs and select its fresh
index with
browser_switch_tab.target_ididentifies the tab;selectedmarks the task target and does not mean foreground focus. - Use
browser_new_tabonly when a separate tab is needed. New/switch calls default to background operation; passactivate: trueonly for an interaction that needs the foreground. The adapter forwards omitted, false and true values unchanged. Write calls still requireconfirm: trueby default. - If the task tab closed, navigation can create one background replacement instead of taking over an unrelated tab. If a create request has an unknown outcome, list/select the intended tab before creating another one.
The first browser launch, an explicit activation and website-created popups can still show a window. This wrapper does not intercept browser windows.
Recovery boundaries
Browser CDP recovery is handled inside nuphus-mcp: it can reattach to a live browser and selected target without reloading the document; cancellation keeps the owned browser alive, and crash recovery reuses the fresh startup page. The adapter does not automatically replay failed or timed-out write calls.
The current @deepseek-ai/dsh-mcp-client does not automatically reconnect a
disconnected MCP server process. Reload the plugin with HMR or restart DSH, then
list/select the intended task tab again. The old reconnect option was not
implemented by that client; it is now ignored with a diagnostic rather than
advertised as a working setting.
Magpie / existing binaries
When Magpie already manages nuphus-mcp, use its existing binary. For a profile
using this adapter, apply these fields to the existing plugin row's config:
command: 'D:\工具\Nuphus\nuphus-mcp.exe'
args: ['--confirm-write']
autoInstall: false
Replace the example with the actual managed path. If Magpie already mounts a
native MCP row for serverName: nuphus-mcp, use that row or this adapter; enabling
both claims the same tool namespace and is rejected by the MCP client. Reload
the relevant client after replacing a binary so existing sessions use the new build.
External-browser selection (NUPHUS_MCP_BROWSER_CDP_URL, NUPHUS_BROWSER_*),
the explicit intranet opt-in (NUPHUS_MCP_ALLOW_PRIVATE_NAV) and action-effect
waiting (NUPHUS_MCP_EFFECT_TIMEOUT_MS) pass through from the host. Explicit
config.env values take precedence; the adapter does not enable private-network
navigation or disable effect checks by default.
Tool list, vision keys and external-browser CDP setup live in the nuphus-mcp README.
License
MIT
Links
More in this category
Tencent/WeKnora#dsh-weknora★ 37587
Four read-only tools over a WeKnora knowledge base: list knowledge bases, hybrid passage search, reassemble one document's chunks in order, and WeKnora's own cited RAG or ReAct-agent answer with a resumable session id.
DayuanJiang/next-ai-draw-io#dsh-plugin★ 37004
Draws draw.io diagrams in DeepSeek Harness through the next-ai-drawio MCP server: the link in the reply opens a live preview in the right sidebar, you can edit the diagram by hand, and each AI change is a version you can restore. Node.js 18+; npx downloads the MCP server on first use.
superdesigndev/treg★ 8181
Tool catalog for agents: search ~2,600 external endpoints (SEO and SERP, backlinks, social, people and company enrichment, ad libraries, scraping) by the task you want done, read each one's parameters and per-call price, then call it with the credential injected server-side. Ships the skill plus an MCP row that stays disabled until TREG_TOKEN is set.
T-Auto/dsh-ops★ 5867
Provides bash, PowerShell 7, and high-performance Rust tools for DSH on Windows to reduce token usage.
sixtysevenlf/dsh-blender-plugin★ 2153
Lets a DSH agent drive a local Blender over a direct TCP channel with 15 tools: viewport frames, custom-angle renders, Python execution, headless and job offload, transaction rollback, and a planning layer of 228 ops across 34 families.
helloHub1212/dsh-windows-mcp★ 1490
Bridges the CursorTouch/Windows-MCP desktop automation server into DSH through the official MCP client bridge, registering its screenshot, UI tree snapshot, mouse and keyboard input, clipboard, process and registry tools as mcp__windows__* tools for the model, and adds a windows_mcp_doctor diagnostic tool. Computer Use is off by default and is switched on from the plugin panel.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.