返回目录

mrpulor-gh/nuphus-mcp

编辑精选

mrpulor-gh/nuphus-mcp

桌面自动化 MCP 服务器,通过 Model Context Protocol 让任意 AI 智能体控制屏幕、窗口、鼠标键盘与 Chrome。

前往 GitHub
$ npm install -g @nuphus/nuphus-mcp

MIT 协议的跨平台桌面自动化 MCP 服务器:通过官方 dsh-nuphus-mcp 插件把 38 个 stdio 工具以原生方式挂载进 DeepSeek Harness,内置本地 OCR 与 BYOK 视觉能力。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-21

许可证

MIT

01它能帮你完成什么?

  • Give DeepSeek Harness computer-use MCP tools to control the desktop and Chrome

    38 MCP tools (15 desktop + 23 browser) registered in DSH as `mcp__nuphus-mcp__*` — screenshots, window control, mouse/keyboard, Chrome CDP automation

    Developers running DeepSeek Harness (dsh) who want their agent to operate the screen, windows and browser hands-free

  • Automate Chrome workflows from DSH sessions

    Browser automation: navigate, snapshot (accessibility tree with `@N` refs), click, type, scroll, extract, screenshot, cookies get/set/import, tabs and downloads

    Automation engineers who want an AI agent inside DeepSeek Harness to drive their own Chrome or an external fingerprint browser via CDP

  • Ground agent actions in what's on screen with vision and local OCR

    `desktop_vision` (BYOK screenshot analysis via OpenAI-compatible or Anthropic native API) plus `desktop_perceive` (local PaddleOCR, optional YOLO icon detection) — semantic understanding plus pixel-precise coordinates

    Teams building computer-use agents in DSH that need reliable element coordinates without sending screenshots to a hosted vision service

02如何接入 DeepSeek Harness?

前置条件

  • Chrome or Edge installed — required for browser tools (the server auto-detects an installed browser)
  • macOS only: Accessibility permission (System Settings → Privacy & Security → Accessibility) for desktop input
  • Rust toolchain (stable) only if building from source with Cargo — not needed for the npm install path

安装步骤

  1. 01

    Install via npm (recommended, all platforms, prebuilt binaries): `npm install -g @nuphus/nuphus-mcp` — puts the `nuphus-mcp` command on your PATH, no Rust toolchain needed

    $ npm install -g @nuphus/nuphus-mcp

  2. 02

    Recommended for DSH — install the official plugin: `npx -p @deepseek-ai/dsh dsh plugin --profile web add github:mrpulor-gh/dsh-nuphus-mcp`

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

  3. 03

    Manual alternative — mount in DSH's `cordis.yml` as a stdio MCP server via `@deepseek-ai/dsh-mcp-client` (command: nuphus-mcp, args: ["--confirm-write"], toolCallTimeoutMs: 120000)

  4. 04

    Recommended: enable strict confirmation with `--confirm-write` or `NUPHUS_MCP_CONFIRM_WRITE=1` so destructive tools require an explicit `"confirm": true` argument

验证接入成功

  • Quick smoke test: `echo '{"jsonrpc":"2.0","id":0,"method":"initialize",...}' | nuphus-mcp` — the server reads newline-delimited JSON from stdin and writes JSON-RPC responses to stdout

03DSH 适配与能力边界

DSH 适配原生运行时

Official dsh-nuphus-mcp plugin mounts nuphus-mcp into DeepSeek Harness as native tools with zero config (--confirm-write on by default); manual alternative via DSH's built-in stdio MCP client

  • 38 MCP tools over stdio (15 desktop + 23 browser)

    JSON-RPC 2.0 requests from any MCP client over stdinscreenshots, window control, mouse/keyboard, clipboard, Chrome CDP automation — one binary, no daemon, no network service

    tools physically control screen, windows, mouse and keyboard on the host machine
  • Computer vision pair (desktop_vision + desktop_perceive)

    screenshot of the current screensemantic analysis from your own vision LLM (BYOK) plus local PaddleOCR text elements with pixel coordinates; optional YOLO icon detection

    desktop_vision sends screenshots to your own vision LLM endpoint (BYOK API key required)first perceive call downloads OCR/YOLO models into %APPDATA%\Nuphus\models (or NUPHUS_MODELS_DIR)
  • Chrome automation via CDP (managed or external browser)

    browser tool calls; optionally NUPHUS_MCP_BROWSER_CDP_URL to attach to an external/fingerprint browsernavigate, click, type, extract, screenshot, cookies, tabs, downloads — with self-healing port re-resolution for fingerprint browsers

    launches and manages a Chrome instance by default; attaches to your external browser when NUPHUS_MCP_BROWSER_CDP_URL is set (never kills it on exit)
  • Safety-first write controls

    --confirm-write flag or NUPHUS_MCP_CONFIRM_WRITE=1destructive tools require an explicit "confirm": true argument, otherwise the tool is rejected with isError; path validation for screenshots, uploads and file drags

04适合谁?何时不该用?

适合

  • Developers running DeepSeek Harness (dsh) who want their agent to operate the screen, windows and browser hands-free
  • Automation engineers who want an AI agent inside DeepSeek Harness to drive their own Chrome or an external fingerprint browser via CDP
  • Teams building computer-use agents in DSH that need reliable element coordinates without sending screenshots to a hosted vision service

不适合

  • Desktop control is full on Windows (Win32); on macOS desktop input requires Accessibility permission; on Linux window/input capabilities are partial.
  • The server can physically control the machine it runs on; by default write tools run without confirmation, so enabling --confirm-write (or NUPHUS_MCP_CONFIRM_WRITE=1) is strongly recommended.

05兼容性、维护与安全提示

  • Desktop control is full on Windows (Win32); on macOS desktop input requires Accessibility permission; on Linux window/input capabilities are partial.
  • The server can physically control the machine it runs on; by default write tools run without confirmation, so enabling --confirm-write (or NUPHUS_MCP_CONFIRM_WRITE=1) is strongly recommended.
  • Desktop & browser automation need no API key, but desktop_vision requires a BYOK vision endpoint, and the first desktop_perceive call downloads OCR/YOLO models from the network.
2026-08-012026-08-18v0.1.12

MIT · actively maintained (latest release v0.1.12, 2026-08-17)

06常见问题

如何把 nuphus-mcp 接入 DeepSeek Harness?

推荐安装官方 dsh-nuphus-mcp 插件:`npx -p @deepseek-ai/dsh dsh plugin --profile web add github:mrpulor-gh/dsh-nuphus-mcp`。它会把 nuphus-mcp 以原生工具形式零配置挂载进 DSH,且默认开启 --confirm-write。也可以在 DSH 的 cordis.yml 中通过内置的 `@deepseek-ai/dsh-mcp-client` 手动挂载为 stdio MCP 服务器。

DSH 用的是原生工具还是普通 MCP 模式?

两种都可以。官方插件把 38 个工具原生挂载进 DSH;手动方式则把 nuphus-mcp 作为普通 stdio MCP 服务器接入,工具注册为 `mcp__nuphus-mcp__*`。无论哪种方式,都请在你想控制的机器上的桌面会话中运行 DSH。

需要 API key 吗?

桌面和浏览器自动化都不需要。只有 `desktop_vision` 需要你自带视觉模型(BYOK,通过 NUPHUS_MCP_VISION_* 环境变量支持 OpenAI 兼容或 Anthropic 原生协议);`desktop_perceive` 在本地运行 PaddleOCR,首次调用时自动下载模型。

支持哪些平台?

浏览器工具在 Windows 和 macOS 上功能完整,Linux 可用。桌面工具在 Windows(Win32)上功能完整,macOS 需授予辅助功能权限,Linux 为部分支持。npm 提供 Windows x64/arm64、macOS arm64 和 Linux x64/arm64 的预编译二进制。

如何保证写操作的安全?

该服务器可以物理控制它所在的机器。使用 `--confirm-write` 或 `NUPHUS_MCP_CONFIRM_WRITE=1` 开启严格确认后,破坏性工具必须携带显式的 "confirm": true 参数才会执行;dsh 插件默认已开启 --confirm-write。

08数据与来源

  • 作者声明github.com30f261a1689b…

    It mounts nuphus-mcp into DSH as native tools with zero config — `--confirm-write` on by default, no code change needed:

  • 作者声明github.com30f261a1689b…

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

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。