ディレクトリに戻る

mrpulor-gh/nuphus-mcp

キュレーション掲載

mrpulor-gh/nuphus-mcp

デスクトップ自動化 MCP サーバー — 画面、ウィンドウ、マウス/キーボード、Chrome を MCP(stdio)経由で制御

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

02DeepSeek 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 キーは必要ですか?

デスクトップとブラウザの自動化には不要です。`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。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。