zeronews-mcp 是 ZeroNews 官方提供的一组 MCP 工具,面向 Cursor、Claude、Codex、DeepSeek 及各 AI harness 等 Agent 宿主;让 Agent 自动安装 ZeroNews 客户端,并连接控制台完成隧道与域名的全生命周期管理。

接入 MCP

手动安装 MCP

在 AI agent IDE 编辑器中添加 MCP 连接器 如在 Cursor 中添加,在 设置 - customize 的 MCP 配置中,将下面的 配置添加到 mcp 配置中

也可以让 Agent 帮我买按照

主要 MCP 工具

MCP 生效后可用(逻辑工具名;WorkBuddy / Harness 等宿主可能显示为 mcp__zeronews__<工具名>,见 宿主适配)。下表与 npm 包 zeronews-mcp@latest 当前公开的 30 个工具一致(调用结果请检查 JSON 中的 ok 字段)。

ZeroNews MCP 的应用示例

映射本地 Web 服务

将本机已在 3000 端口监听的 HTTP 服务暴露为公网 HTTPS 入口。
典型工具链: client_status →(未登录)login → expose_local_service(port: 3000,类型一般为 https)。若 3000 未在监听,Agent 应先说明本地服务未就绪,而不是改猜其它端口。

添加自定义域名并代理

先为账号添加平台子域(如 arpweb),再将本机服务绑定到该域名。
典型工具链: login 后 add_domain(subdomain 为 arpweb 或按工具返回的候选选择)→ 再 expose_local_service 或 add_tunnel,在参数中指定该域名及本机端口(用户未给端口时先 list_local_listeners 并请用户选择)。

SSH 远程隧道

将远端主机 192.168.1.200:22 的 SSH 以 TCP 隧道形式发布到公网(需本机 ZeroNews 客户端已登录且在跑)。
典型工具链: client_status → login → add_tunnel 或 expose_local_service(隧道类型 tcp,目标为对应该远程地址/转发的配置;具体字段以 MCP 工具 schema 与规程为准)。若产品要求先在本机建立到内网的转发,Agent 应说明网络前提,禁止在未确认可达性时声称已映射成功。

LFS 分享目录

将本机目录 /opt/share 以文件空间(LFS / file_share)形式分享出去。