前言
现在大家用 Cursor、WorkBuddy、Codex、Claude 这些 AI，写代码、查日志、跑命令、连内网 MCP 都很顺手了。但一到内网穿透，往往还得自己装客户端、打开控制台加隧道——比如本机 3000 端口的 Web 服务，或者 SSH，需要在浏览器和终端之间来回切换，很打断节奏。
ZeroNews MCP 连接器就是为了解决这个痛点：把「记命令、切控制台」变成对话里可编排的工具链，让 AI Agent 替你完成从安装客户端到创建隧道的全部操作。
什么是 ZeroNews MCP 连接器
ZeroNews MCP 连接器是 ZeroNews（零讯）官方提供的一个 MCP 工具服务，给 Cursor、WorkBuddy、Claude Desktop 这类带 MCP 的智能 Agent 使用。
它提供一组 MCP 工具，把你在控制台和本机 zeronews 客户端上的日常操作交给连接器自动完成。你只需要通过自然语言描述意图，Agent 就会按顺序调用这些 MCP 工具，帮你完成：
- 安装客户端
- 设置 Token
- 查找本机服务
- 添加隧道
不用自己背命令，也不用在浏览器里一步一步操作。
连接器是怎么工作的
你在对话里说「想映射本机某个服务」，AI 就会通过 MCP 调用连接器。整体流程一步一步来：哪一步没过——比如 Token 还没绑定——它不会硬给你建隧道，避免出现「隧道建了却访问不通」的中间状态。
对话意图（映射某内网应用） │ ▼ ┌───────────────────┐ │ 1. 客户端是否就绪 │ └─────────┬─────────┘ │ ▼ ┌───────────────────┐ │ 2. 绑定 Auth Token │ └─────────┬─────────┘ │ ▼ ┌───────────────────┐ │ 3. 发现本机服务 │ └─────────┬─────────┘ │ ▼ ┌───────────────────┐ │ 4. 建立隧道并输出 │ └───────────────────┘检测本机是否已安装 ZeroNews 客户端，未安装则自动安装
加隧道之前，连接器会先检查本机有没有zeronews。没有的话，会按官方渠道根据你的系统自动下载安装；已经安装了但没跑起来，它会通过service_start把客户端拉起来。
未绑定 Token 的客户端，完成 authtoken
新安装的客户端还没绑定 Token 时，会弹窗让你把控制台复制的 Token 贴进去，连接器帮你执行zeronews authtoken。
发现本机服务，供你选择要映射的内网应用
建隧道前，它会列出本机正在监听的端口，你在列表里点选要映射的那一项即可。
自动完成隧道建立，输出访问地址
选好端口后，它去创建 HTTPS / TCP / LFS 隧道，最后把公网访问地址返回给你。
安装 ZeroNews MCP 连接器
ZeroNews 在 npm 上提供了官方包，一般用npx就能接上。
方式一：npx 安装（推荐）
无需全局安装。Cursor 这类宿主启动 MCP 时，会执行 npx，自动拉取并运行包。
npm view zeronews-mcp version在 MCP 配置文件（Cursor 为 .cursor/mcp.json）中加入 zeronews 这一项（建议把 @latest 换成查到的固定版本号，更稳定）：
{ "mcpServers": { "zeronews": { "command": "npx", "args": ["-y", "zeronews-mcp@latest"] } } }方式二：npm 全局安装
如果希望命令固定、少走一层 npx，可以全局安装。
npm install -g zeronews-mcp@latest安装完成后，MCP 配置需要改为直接调用安装后的命令（不能继续用 npx 那段配置）。
{ "mcpServers": { "zeronews": { "command": "zeronews-mcp", "args": [] } } }验证连接器是否安装成功
配置完成后，确认 MCP 列表里 zeronews 显示「已连接」，没有持续报错。然后在对话里试一句：
「列出本机监听端口」或「帮我把本机 3000 映射到公网」
走一遍完整流程：安装客户端 → 表单绑定 Token → 选择端口 → 拿到公网 URL，即表示连接器工作正常。
典型使用场景
场景一：本地 Web 服务一键映射公网（临时给同事看 Demo）
本地开发时，临时想让同事看一下 Demo，直接在对话里说：
帮我通过 ZeroNews MCP 映射本机 WEB 服务
连接器会先检查客户端状态，然后列出本机监听端口（如 3000 / 8080），你选择要映射的 Web 服务，再确认映射类型（WEB 服务默认用 HTTPS，域名由服务端分配），隧道创建成功后返回公网访问地址。
场景二：内网本机 SSH 远程连接映射
需要把内网主机（如 172.16.10.6）的 SSH 22 端口映射出来，远程连接时可以直接说：
帮我把内网本机 172.16.10.6 的 SSH 22 端口通过 ZeroNews MCP 映射出来
场景三：本地目录开通 LFS 文件空间
需要把某个本地目录共享为 LFS 文件空间时，可以说：
帮我把本机 /Users/arp/zeronews/blod-doc/platform/lfs/demo/enterprise-docs 目录，映射成 LFS 文件空间
连接器会确认目录存在、生成管理员账号密码，并将目录通过运行中的 ZeroNews 客户端发布出去，返回共享目录、公网地址和管理员账号信息（密码为创建时自动生成，登录文件空间管理页时使用）。
小结
ZeroNews MCP 连接器把内网穿透从「记命令、切控制台」变成对话里可编排的工具链：通过自然语言下指令，即可完成 ZeroNews 客户端安装与 HTTPS / TCP / LFS 隧道创建，用户不用再查命令、查用户手册，任何人都能简单上手。
如果你也在用 Cursor、Claude 这类 AI 编码工具，不妨装上后试一句「帮我把本机 3000 映射到公网」，感受一下一句话完成内网穿透。觉得有用的话，欢迎收藏、转发给同样被内网穿透折腾过的朋友。
