# @dev-zero/mcp-agent 中文文档

规范地址：https://npmcn.com/package/%40dev-zero/mcp-agent/

版本：0\.0\.33
npm 元数据更新时间：2026-11-08T14:27:45.895Z
中文译文更新时间：2026-11-12T01:59:54.732Z
软件包许可：UNLICENSED

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dev-zero/mcp-agent
原文对照：https://npmcn.com/package/%40dev-zero/mcp-agent/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：74.6 MB，63 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：4 个
- 首次发布：2026-10-13T16:27:17.155Z
- 最新版本发布：2026-11-08T14:27:45.701Z
- 近 30 天下载量：5394（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：34（近 12 个月 34 个）

## 中文简介

Zero Server MCP网关的独立零代理

## 安装

```sh
npm install @dev-zero/mcp-agent
```

也可以使用：`pnpm add @dev-zero/mcp-agent`、`yarn add @dev-zero/mcp-agent`、`bun add @dev-zero/mcp-agent`

## README

# @dev-zero/mcp-agent — Zero SERVER (英语). 探员

Android/Termux直接代理集成在已发布的软件包中(参见 [安地罗得·姆德](https://npmcn.com/package/%40dev-zero/mcp-agent/ANDROID.md)) (中文(简体) ). 在授权的NX769J Android/arm64 Termux设备上核查本地入学和直接代理准备情况 `@dev-zero/mcp-agent` v0.0.19:设备代码确认,保存身份恢复,直接核心连接,7个能力同步,授权准备,认证投票/心跳,设备准备全部完成,没有Windows/ADB传输. `zero.mobile.devices` 财务报告和审定财务报表 `zero.mobile.screen_size` 也进行现场验证;当前直接截图返回 `MOBILE_SCREENSHOT_FAILED` 并且不会被证实.

独立零位服务器 探员包裹 已公布的软件包不依赖于开发者取出路径. 未重新命名或重新公布 `@miruzero/zero-agent` (原始内容存档于2019-09-21). in Zero HOME.

## Android / Termux 快速启动

```sh
npm install -g @dev-zero/mcp-agent@latest
zero-agent remote
```

在第一次互动运行时, `remote` 显示短 `XXXX-XXXX` 如果此 Termux 设备代码 安装尚未注册。 用户在ChatGPT中明确确认该代码; 2; 没有电话 `zero.mobile.confirm`手机将它的身份保存在私人电脑下 `~/.zero-agent/identity.json`,然后继续启动. `zero-agent enroll` 仅保留为 留下明确的邀请/恢复路径.

一个直接的Android代理广告 `mobile_android_devices`, (中文(简体) ), `mobile_android_screen_size`,以及 `mobile_android_screenshot` 在公众面前 `zero.mobile.*` 路线。 选中的直接设备序列是当前 `local`; 调用者 仍然必须使用活工具返回的序列。 此路径不依赖于 Windows代理或亚行运输. 使用经认证的民调+心跳 默认; 长寿的实时频道仍然是桌面默认, 是 Android 选择使用 `ZERO_ANDROID_REALTIME_CHANNEL=1`。 。 。 .

## 窗口快速启动

使用范围包名来避免旧的全局 `zero-agent` 二进制 :

```powershell
npx -y @dev-zero/mcp-agent@latest remote
```

此代理连接到 Zero SERVER 网关, 并在可用时安全恢复其每个用户的本地身份 。 运行 `npx -y @dev-zero/mcp-agent@latest --help` 对于可用的命令.

在全新的Windows用户/Chrome安装上,选择或创建Chrome配置 并在 `https://chatgpt.com/` 当特工报告当地失踪时 届会。 在第一个设备代码注册期间,代理 继续投票和重新检查 chrome 会话没有生成另一个代码或要求重新启动; 它 在真正本地的 ChatGPT 证书通过之前, 绝不声称授权成功 . 如果设备代码过期, 请开始新的注册 。 没有远程连接到 当地Chrome的登录步骤需要新的机器.

源检出 :

```powershell
Set-Location C:\path\to\zero-agent
npm install
npm start
```

`npm start` 引用此软件包本身 `bin/zero-agent.mjs` CLI(英语:CLI). 正常启动隐藏内部遥测( E)`ZERO_AGENT_*`)和本地配对 URL; 仅显示可操作连接状态或浏览器设备代码 当实际需要批准时。 运行 `npm start -- --debug` 来看看 内部本地用户界面地址,协议事件和用于诊断的频道错误. 本地身份 UI 即使其 URL , 仍然必然会回放和可用 未打印。 频道故障作为普通语言的警告仍然显而易见; 他们从来不造谣 `Device ready` 留言. 当一个更古老的"零"代理正在监听所配置的本地 UI 端口时( 默认) `8054`),启动验证其Windows进程所有者和精确的Agent入口, 检查后继者是否有可解密的 DPAPI 身份,然后停止旧的 代理进程树并启动替换 。 不需要手动 PID 杀死 . 一个无关的收听器永远不会停止, 如果拥有则启动失败 或无法核实全权证书。 测试使用孤立的麻黄口.

对于一个 **仅限 0 SERVER 退出**,第一个启动可能会复制已有的 `state/agent/worker-credential.dpapi` 输入用户- 本地 AppData 金库, 不包含 覆盖或删除原始文件 。 独立安装的软件包 不读取兄弟项目树 .

如果没有注册身份, Agent 开始本地的 MCP, 联系 Core 并自动请求15分钟的设备代码。 确认密码在 已注册的 ChatGPT OAuth 页面; 在本地 ChatGPT 会话校验后, Core 发布一个独特的设备标识 特工安全地坚持其身份. 若为 `%LOCALAPPDATA%\ZeroAgent\identity.dpapi` 存在,它恢复了这个身份 无需请求新代码。 遗产 `enroll` 命令仍然是可选的. `npm run doctor` 打印CLI的使用; `npm run status` 询问本地主机特工UI.

代码在 `bin/` 财务报告和审定财务报表 `src/` 并且只使用已宣布的依赖关系. 核心拥有OAuth赠款授权,注册,路由和全球UI. 特工拥有 本地证书、ChatGPT会议段证明、外出频道、工人和当地用户界面.

**状态 :** Bundled默认以适合平台的能力启动经认证的本地MCP. Windows使经核实的PC/计算机在可用时能够使用地表和便携式亚行移动发现. Android 默认会禁用破坏性计算机控制,曝光只读文件系统/进程兼容工具,并直接广告 `zero.mobile.*` 设备/大小/屏幕截图路由,没有主机 ADB。 在NX769J上,原生Android的入学、恢复身份、7个工具的能力同步、授权、投票/心跳、设备准备、直接移动发现以及 `zero.mobile.screen_size` 已用v0.0.19核实。 活屏幕结果为1116x2480,比例为2.23125. `zero.mobile.screenshot` 仍然无法证实。 较新的构建精确地对截图失败进行分类,并且永远不会自动升级;一个明确授权的植入Android可以选择在固定根后倒置中 `ZERO_ANDROID_ROOT_SCREENSHOT=1`。 。 。 . 冰冻的β在 `packages/zero-agent` 是一个单独的历史运行时间 仍然支持 `system.info` 用于现有现场用户。 一个真正的新用户 ChatGPT OAuth 调用、生产代理替换和重新连接仍然保留 未经核实的验收门.

## Atlas亚剂路由(仅国内)

零核心 `zero.subagent` 选择条形图集身份并返回本地 产卵清单。 主机本地的 ChatGPT 子代理工具执行执行; 0 当地特工不经营阿特拉斯系统 旧的 `zero.subagent.execute` → `zgpt_atlas_worker` 队列- 发送路径已退出 。 遗产 `ZERO_AGENT_ATLAS_TOOLS` 财务报告和审定财务报表 `ZERO_AGENT_ZGPT_TOOLS` 不再开关 (c) 广告或允许Atlas系统工作人员使用。 现有任务记录仍可读取 历史状况和审计.

分开 `src/tools/zero-chatgpt-client.mjs` 模块仍在源代码中 树,但并未注册为当地阿特拉斯系统工人.

## 用 EOTP 出版

探员的 **仅限来源** 释放帮助器遵循已验证的零 EOTP 释放工作流程. 这叫安装 `zero eotp npm --json`中,仅将结果的6位数 TOTP 传递给 npm 进程 `npm_config_otp`,从不登录或存储代码。 帮助者被排除在已公布的Agent tarball之外.

```powershell
Set-Location C:\path\to\zero-agent
npm run release:eotp:check      # Tests, pack audit, public-registry version check; NO publish
npm run release:eotp             # Verify npm login, obtain new EOTP, publish, verify registry
```

这需要一个 **普通在线 PowerShell 会话** 以配置的 Windows 用户运行 `zero eotp npm`如果环境强制执行 `npm_config_offline=true`,帮助者报告 `NPM_OFFLINE_ENV` 没有试图虚假的出版。 npm 账户令牌需要权限才能发布 `@dev-zero/mcp-agent`;仅拥有一个有效的检察官办公室并不授予软件包许可。 检察官办公室错误( E)`EOTP`)与注册HTTP404(版本缺席,权限,或包访问)不同. 只有当登记册为准确公布的版本服务时,才会发布该版本;没有发生自动版本突起、进程重新启动或npm全局安装.

**发布元数据 :** `@dev-zero/mcp-agent` 为公共 npm 发行配置 `publishConfig.access=public`包装准备状态不是登记册公布成功的证据。 项目运行时间和证书仍留在本地机上;不将它们列入npm档案.

## 本地代理 CLI( npm / npx)

以下命令使用已安装的软件包,而非工程全局状态 :

动力壳 npx -y @dev-zero/mcp- agent@latest 帮助 npx -y @ dev-zero/ mcp- agent@latest kill (英语) npx -y @ dev-zero/ mcp- agent @latest 删除 \`\`\`

-   **帮助**: 打印支持的 CLI 命令 .
-   **杀死**: 仅当 Windows 用户, 可执行文件时, 才会停止一个已存在的本地 Zero Agent, 程序命令、监听端口和代理 HTTP 状态可以得到验证. 不相关的进程永远不会终止.
-   **删除**: 执行相同的经核实的站点,然后取消所有者注册 \`零代理人' 当前Windows用户登记册中的URL启动器. 这个 **保留** DPAPI 身份、会话、配置、数据库和 npm 缓存. 它不取消核心OAuth赠款或解开npm包.
-   当本地代理没有运行时, \`杀死' 返回' 命令 : “ 杀死” , “ 停止 ” : 虚假 " 移动 " 报告注册发射装置是否被取出.
-   如果所有权未经核实,两个命令都拒绝阻止目标.

## 代理启动细节

运行 `npx -y @dev-zero/mcp-agent@latest remote` 打印 **已安装** 软件包版本,已解析设备名称(Android模型或桌面主机名),平台/architecture,Node.js runtime,, 进程 ID, 本地主机 UI 端口和连接前的启动时间戳 .

核心授权后,能力同步和成功认证 心跳/弹出周期,代理打印其核心主机,注册的本地MCP工具计数, 经核实的授权,运输模式和心跳状态。 桌面报告 `Transport: Realtime`; Android 直接正常报告 `Transport: Polling`。 。 。 .

控制台不打印保存的身份符、 授权信头、 任务 参数、文件内容或 API 机密。 任务开始/COMPLTED/FAILED行 只在授权任务实际到达代理时才会出现。 更新一个 npm 软件包不替换运行的代理进程; 重新启动以加载 a 新版本一旦安全地中断任何正在工作.

## Linux 快速启动

Linux 主机使用无头代理路径和MCP设备代码批准流程. 特工将身份保存在 `~/.zero-agent/identity.json`; 目录必须由代理用户和模式拥有 `0700`,身份文件必须是模式 `0600`不安全的所有权或许可无法关闭.

默认的 Linux PC 目录是故意只读的 :

-   Linux 系统、 CPU、 内存和文件系统信息
-   通过代理用户可见的进程 `/proc`
-   目录列表和 UTF-8 文件在核定根下读取
-   多文件的阅读有明确的字节和时间预算

默认的Linux配置文件不发布Win32计算机使用,PowerShell,Register,桌面截图或剪贴板工具的广告. 默认允许的root是代理用户的主目录.

敏感的 Linux 控制需要单独明确的选择进入 :

-   POSIX shell 执行 : `ZERO_PC_CONTROL_ENABLED=1` 财务报告和审定财务报表 `ZERO_LINUX_SHELL_ENABLED=1`
-   文件写入和允许的根换 : `ZERO_PC_CONTROL_ENABLED=1` 财务报告和审定财务报表 `ZERO_LINUX_FILE_WRITE_ENABLED=1`

Linux 游戏 `kill` 命令只停止从这个精确的包入点运行一个经核实的同源UID代理。 链接 `remove` 不运行未安装的 Windows 协议并保存身份文件.

## Linux 核心简介

在Linux上, `npm start` 运行端口上的节点核心服务组 `8050, 8051, 8052, 8053, 8055`Nginx入侵和当地特工服务 `8054` 是外部 Linux 管理的服务; Linux 配置文件不引用 Windows Nginx 验证器、 Windows 进程接管和 Windows 本地代理恢复。 使用单独管理的 Linux 逆向代理和服务管理器进行部署.

## 常见问题

### @dev-zero/mcp-agent 是什么？

Zero Server MCP网关的独立零代理

### 如何安装 @dev-zero/mcp-agent？

在项目目录运行 npm install @dev-zero/mcp-agent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 zero-agent，可以用 npx zero-agent 直接运行。

### @dev-zero/mcp-agent 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dev-zero\_\_mcp-agent 是否存在。

### @dev-zero/mcp-agent 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dev-zero/mcp-agent 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dev-zero/mcp-agent 可以商用吗？

@dev-zero/mcp-agent 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @dev-zero/mcp-agent 的下载量有多少？

根据 npm 官方下载统计，@dev-zero/mcp-agent 在 2026/10/12 – 2026/11/10 这 30 天内被下载 5,394 次，日均约 180 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dev-zero/mcp-agent 还在维护吗？

最新版本 0\.0\.33 发布于 2026/11/08（3 天前）；至今共发布 34 个版本，其中过去 12 个月发布了 34 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。