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 个工具,两个域
| 工具域 | 数量 | 说明 |
|---|---|---|
| 桌面 | 22 | 截屏 · 窗口 · 键鼠 · 剪贴板 + 语义桌面 |
| 浏览器 | 23 | navigate · 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,发给你自己选的视觉模型)组成。
一条接入链路
一个二进制把两套执行核接进协议。链路里没有第三样东西。
接进来,三步
- 01install 全局安装 npm i -g @nuphus/nuphus-mcpPATH
- 02register 客户端里注册 mcpServersstdio
- 03protect 建议开启 --confirm-writesafe
{
"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 走你的模型。
一个二进制,多一双手
下载 Nuphus
MIT 开源 · Rust 实现 · Gitee 同步镜像。你的桌面,从此可以被任何 Agent 使用。