DeepSeek Harness 插件

mrpulor-gh/dsh-nuphus-mcp

Star 数 ★ 5 下载量(近 30 天) 1,314 分类 工具与能力 收录于 2026-08-19 npm dsh-nuphus-mcp

nuphus-mcp 官方 DSH 插件(由 nuphus-mcp 维护者发布):桌面 + 浏览器自动化(38 个工具),配 PaddleOCR 元素感知与 Chrome CDP 浏览,经常驻 stdio MCP 子进程接入。

安装

# npm 包(预构建)

dsh plugin --profile web add dsh-nuphus-mcp

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:mrpulor-gh/dsh-nuphus-mcp

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

DSH 插件:把 nuphus-mcp 挂载为 DSH 原生工具——为你的智能体提供"计算机使用"能力。不含任何 nuphus-mcp 代码:只是 薄 Cordis 外壳,经 @deepseek-ai/dsh-mcp-client 以 stdio 拉起 nuphus-mcp 二进制。

安装

npx -p @deepseek-ai/dsh dsh plugin --profile web add github:mrpulor-gh/dsh-nuphus-mcp

重启 dsh --profile web 即自动激活(dsh.bundle.patch)。

效果

  • 动态发现并注册服务端工具为 mcp__nuphus-mcp__*,数量和 schema 由实际连接的服务端构建决定
  • 首次启动时若 PATH 上没有 nuphus-mcp 会自动安装
  • 默认开启 --confirm-write(写工具需显式 "confirm": true)
  • 与其他客户端共用同一套 NUPHUS_MCP_* 环境变量
  • 插件存活期间复用同一个 MCP 客户端;保留服务端工具描述、调用参数和返回内容

环境要求

  • DSH web profile,Node.js ^22.19 / >=24
  • DSH 需运行在被控机器的桌面会话里

配置

可在 cordis.yml / patch 中覆盖:

字段 默认值 说明
serverName nuphus-mcp 工具命名空间
command nuphus-mcp 要启动的可执行文件
args ["--confirm-write"] 命令行参数
autoInstall true 默认命令不在 PATH 时自动安装;受管理的安装可设为 false
toolCallTimeoutMs 120000 单次调用超时(截图/OCR 超过 60000)

autoInstall 必须是布尔值。自定义 command 始终按原值使用,支持空格和中文路径, 不会触发自动安装。Windows 命令探测和安装进程采用隐藏窗口选项,MCP SDK 也会隐藏 stdio 子进程窗口。

复用任务页面

请使用包含 nuphus-mcp PR #12 和 PR #13 的服务端构建,例如 提交 0a689c1。 已发布的 v0.3.3 早于这些修改,仅凭 0.3.3 版本号无法确认是否包含修复。 只更新本适配器或自动安装旧 npm 构建,不会获得新的浏览器行为。

使用上述服务端时:

  1. 普通导航使用 mcp__nuphus-mcp__browser_navigate,继续复用选定的任务页, 首次导航也会接管启动页。
  2. 需要使用另一已有标签页或网站弹窗时,先列出标签页,再用最新的 index 调用 browser_switch_tab。target_id 是稳定标识;selected 表示任务目标,不代表前台焦点。
  3. 只有确实需要独立标签页时才调用 browser_new_tab。新建和切换默认在后台完成; 需要前台交互时显式传入 activate: true。适配器原样透传省略、false 和 true, 写操作仍默认要求 confirm: true。
  4. 任务页已关闭时,导航可以创建一个后台替代页,不接管无关标签页。 开页结果未知时,先列出并选定目标,再决定是否新建,避免重复开页。

首次启动浏览器、显式激活和网站自身弹窗仍可能显示窗口。本适配器不拦截浏览器窗口。

恢复边界

浏览器 CDP 恢复由 nuphus-mcp 服务端处理:重新连接活浏览器及选定目标时不刷新文档; 取消重连保留受管浏览器进程,崩溃恢复复用新启动页。适配器不会自动重放失败或超时的写操作。

当前 @deepseek-ai/dsh-mcp-client 不支持 MCP 服务进程断线后的自动重连。 需要通过 HMR 重载插件或重启 DSH,再次列出并选定任务页面。原先的 reconnect 配置实际未被该客户端实现,现在会提示其不受支持并忽略,不再把它描述为有效能力。

Magpie / 已有程序

如果已通过 Magpie 管理 nuphus-mcp,请使用其现有程序。选择本适配器接入的 profile, 可将以下字段配置到已有插件条目的 config:

command: 'D:\工具\Nuphus\nuphus-mcp.exe'
args: ['--confirm-write']
autoInstall: false

请把示例路径替换为实际受管路径。Magpie 已挂载 serverName: nuphus-mcp 的原生 MCP 条目时,应在该条目与本适配器之间选择一种;同时启用会占用相同工具命名空间,客户端会拒绝。 替换二进制后需要重新加载对应客户端,已有会话才会使用新构建。

外部浏览器选择(NUPHUS_MCP_BROWSER_CDP_URL、NUPHUS_BROWSER_*)、内网访问显式开关 (NUPHUS_MCP_ALLOW_PRIVATE_NAV)及动作效果等待(NUPHUS_MCP_EFFECT_TIMEOUT_MS)均可从 宿主透传。显式 config.env 优先;适配器不会默认开启内网访问或关闭效果检查。

工具清单、视觉密钥、外部浏览器 CDP 接入见 nuphus-mcp README。

License

MIT

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。