@dev-zero/mcp-agent

中文文档
0.0.33发布于 2026/11/08UNLICENSEDES Module近 30 天下载 5394

Zero Server MCP网关的独立零代理

中文使用文档
文档目录8 节
  1. Android / Termux 快速启动
  2. 窗口快速启动
  3. Atlas亚剂路由(仅国内)
  4. 用 EOTP 出版
  5. 本地代理 CLI( npm / npx)
  6. 代理启动细节
  7. Linux 快速启动
  8. Linux 核心简介

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

Android/Termux直接代理集成在已发布的软件包中(参见 安地罗得·姆德) (中文(简体) ). 在授权的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 快速启动

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 二进制 :

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的登录步骤需要新的机器.

源检出 :

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之外.

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, 8055Nginx入侵和当地特工服务 8054 是外部 Linux 管理的服务; Linux 配置文件不引用 Windows Nginx 验证器、 Windows 进程接管和 Windows 本地代理恢复。 使用单独管理的 Linux 逆向代理和服务管理器进行部署.

版本与发布记录

@dev-zero/mcp-agent 共发布 34 个版本,首次发布于 2026/10/14;过去 12 个月发布了 34 个版本。

版本发布日期距今
0.0.33latest2026/11/083 天前
0.0.322026/11/065 天前
0.0.312026/10/2914 天前
0.0.302026/10/2914 天前
0.0.292026/10/2814 天前
0.0.282026/10/2814 天前

关于 @dev-zero/mcp-agent 的常见问题

@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 和提交记录判断。