返回目錄

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 外掛,絕不濫發。