Nuphus

Nuphus · Code & Automation

把桌面开放给任何 MCP 客户端

nuphus-mcp 是 Nuphus 的桌面自动化 MCP 服务器:同一套桌面 + 浏览器能力,作为标准 MCP 工具长在任何客户端里——Claude Desktop、Cursor、VS Code、Copilot,或你自己写的 Agent。

45 个标准工具stdio 单进程桌面 / 浏览器零 Key

它在这里干什么

  • 接上任何 MCP 客户端Claude Desktop / Cursor / VS Code / Copilot——协议标准,客户端不挑
  • 桌面与浏览器当标准工具暴露截屏、窗口、键鼠、Chrome CDP——与 Nuphus 桌面应用同一套能力
  • 传输只有 stdio按行分隔的 JSON-RPC 2.0,无守护进程、无 HTTP 服务,就一个二进制

45 个工具,两个域

nuphus-mcp 工具构成
工具域数量说明
桌面22截屏 · 窗口 · 键鼠 · 剪贴板 + 语义桌面
浏览器23navigate · snapshot · click … Chromium CDP
合计45完整清单见仓库 TOOLS.md

7 个语义工具走 Windows UIA / macOS AX 可访问性树:observe → pick candidate → execute → verify,句柄与坐标不出 MCP 边界,客户端只见到不透明 ID 与稳定定位器。视图对由 desktop_perceive(本机 OCR,模型首次调用自动下载)与 desktop_vision(BYOK,发给你自己选的视觉模型)组成。

一条接入链路

一个二进制把两套执行核接进协议。链路里没有第三样东西。

MCP 客户端 Claude · Cursor stdio · JSON-RPC 2.0 nuphus-mcp desktop-api · 桌面 nuphus-browser · CDP 两套执行核
stdio 进,stdio 出。没有端口,没有常驻进程。

接进来,三步

  1. 01install 全局安装 npm i -g @nuphus/nuphus-mcpPATH
  2. 02register 客户端里注册 mcpServersstdio
  3. 03protect 建议开启 --confirm-writesafe
任意 MCP 客户端 · mcpServers 配置
{
  "mcpServers": {
    "nuphus-mcp": {
      "command": "nuphus-mcp",
      "args": ["--confirm-write"]
    }
  }
}

Claude Desktop 写在 claude_desktop_config.json;VS Code / Cursor 用各自的 MCP 设置面板,指向 nuphus-mcp 即可。环境变量比参数更通用:NUPHUS_MCP_CONFIRM_WRITE=1 对本机所有客户端一次性生效。

安全默认,不在文档里

协议层就画了线,不靠客户端自觉。

01危险操作标注

破坏性工具按 MCP 规范标注,客户端可见。

02strict-confirm

写操作需显式 confirm 参数,否则拒绝。

03路径校验

截图、上传与文件拖放的路径一律校验。

04数据由你定

桌面 / 浏览器零 Key;视觉 BYOK 走你的模型。

一个二进制,多一双手

MIT 开源 · Rust 实现 · Gitee 同步镜像。你的桌面,从此可以被任何 Agent 使用。

下载 Nuphus25.2 MB