云上跑 MCP:九成格子是 stdio,出网与常驻进程怎么摆
本次采集的 2,737 个「server × 宿主」格里,transport 记为 stdio 的有 2,499 格,占 91.3%;记为 http 的只有 238 格,占 8.7%(口径:采集文件 mode=full,2026-11-02T19:53Z 生成,2026-11-19 现查)。这个比例决定了上云的第一个动作不是「找一个远程地址填进去」,而是「在一台没有图形界面的机器上,安排一个能长期活着的父进程」。把这件事想清楚,后面关于镜像、安全组、凭据的决定才有依据。
stdio 在云上意味着什么
stdio 不是网络协议,它是父子进程之间的三根管道:宿主 spawn 子进程,server 从 stdin 读 JSON-RPC,把结果写回 stdout,日志走 stderr。所以「部署一个 MCP server」在这套机制下等于三件事同时成立——宿主活着、子进程能被拉起、拉起之后能读到正确的输入。
这带来一个和本地开发完全不同的约束。本地你打开编辑器,宿主本来就常驻;云上你得先决定谁来当这个宿主。桌面宿主在无图形界面的机器上没有落点,能用的只有命令行宿主。本次矩阵里真正有真机结论的恰好也是命令行这一类:claude-code、gemini-cli、qoder 三个宿主,各有同一批 server 的 158 格实测;其余 12 个宿主一条真机证据都没有,合计 1,932 格,占全矩阵 70.6%。这不是说那 12 个宿主不能用,而是说它们在这次采集里的结论来自文档推断和协议实测,不能当成「我这边跑过」来用。
选宿主这件事,可以先去 按平台找 MCP 对一下自己那台机器的形态,再决定装哪一个 CLI。
进程形态:谁拉起谁,包从哪来
stdio server 的常见启动命令有三种:npx -y <pkg>、uvx <pkg>、以及指向本机已有二进制的绝对路径。三种在云上的表现完全不同。
npx 与 uvx 属于「每次启动都可能出网」:第一次没缓存就要去 registry 拉包,缓存目录通常在运行用户的 home 下,容器重建就没了。放在云上,这会变成两个具体问题。一是启动耗时不可控,宿主刷新工具列表有超时(OpenCode 默认只等 5 秒,这条是官方文档写的),冷启动拉包很容易顶到超时,表现为工具列表为空;二是出站策略必须放行 registry,否则进程根本起不来。
更稳的做法是把依赖前移到镜像里:构建阶段装好包,运行阶段用绝对路径启动,command 指向镜像内的可执行文件,args 只留必要参数。这样启动不依赖外网,也不受 registry 抖动影响。代价是升级要重建镜像,版本必须钉死,不要用浮动 tag。
还有一个容易漏的细节:stdio server 的 stdout 就是协议通道,任何一行多余输出都会破坏 JSON-RPC 的帧。不少包默认往 stdout 打日志,本地看不出来,云上被 systemd 或容器日志驱动接管后就直接解析失败。启动参数里如果有日志级别,压到 stderr,或者关掉。
常驻形态本身也要选。宿主要活过单次会话,就得交给 systemd、supervisor 或容器 entrypoint 托管,并显式声明重启策略与工作目录。这里最常见的翻车是 PATH:用 nvm 或版本管理工具装的 Node,路径只写在某个用户的 shell 配置里,systemd 拉起的进程读不到,command 明明是 npx 却报找不到。要么在 unit 里写死绝对路径,要么把运行环境的 PATH 显式注入。工作目录同理,配置里用相对路径引脚本的,换个启动方式就失效。
出网策略:只放必要出站
云主机的安全组通常只管入站,出站默认全通,于是很多人忘了这一层。真出问题时,症状是「进程起来了,但工具调用全部超时」。
需要放行的出站至少有两类:拉包用的 registry(如果你坚持用 npx/uvx),以及 server 自己要访问的目标 API。第二类常被忽略——很多 server 只是薄薄一层封装,真正的请求是它替你发出去的,域名和端口跟宿主完全无关。按 server 的用途逐条列,而不是给整台机器开一个全通。
代理是第二个高频故障点。HTTP_PROXY 与 HTTPS_PROXY 只对遵守它们的客户端生效,Node 生态里有一部分库不读这两个变量,于是出现「curl 能通、server 拉不到包」的分裂现象。NO_PROXY 至少要把 127.0.0.1 和 localhost 排除,否则宿主访问本地 stdio server 的回环流量也会被塞进代理。
证书是第三个。企业环境常做 TLS 中间人,Node 默认不信任自签根证书,报错是 SELF_SIGNED_CERT_IN_CHAIN 这一类。要么把根证书装进系统信任库,要么用 NODE_EXTRA_CA_CERTS 指向证书文件。两条都要在镜像里做,不要指望运行时 export 一次就能长期有效。
出口 IP 是第四个,通常只在对接方要求白名单时才暴露。云主机的公网出口默认是动态的,重建实例就变;对端按 IP 放行时,得先给机器绑弹性公网地址,再把这一个地址报给对方。如果机器同时有 IPv6,注意 server 解析域名时可能优先走 IPv6,而对端只放行了 IPv4,症状是「本机 curl 通、server 调用被拒」。
凭据与权限收敛
stdio 的配置通常是一段 JSON,里面同时放着启动命令和环境变量。最危险的做法是把 token 直接写进这段 JSON,再提交到代码仓库——它会被 git 历史记住,删掉也不算删掉。
可行的收敛顺序是:凭据只走运行时的环境变量或宿主的 secret 机制;配置文件里只出现变量名,不出现值;实例元数据服务能拿到的身份,优先于长期 token。如果 server 支持只读凭据,先给只读,等工具列表和调用链路都验证过再换。
另一半是工具权限。宿主普遍提供「每次调用都问」和「自动批准」两档,本地开发图省事会开自动批准,搬到云上等于给一个无人看守的进程开了写权限。上云时应该反过来:先全手动,确认每个工具的实际副作用,再把只读工具单独放行。写操作、删除操作、涉及账单和工单状态的操作,保持人工确认。
顺便提醒一句:本次矩阵里 59 格是 limited(2.2%),这类格子描述的是「部分工具能用」——往往就是被宿主的工具数上限或原语支持裁掉了。上云前如果只测「server 连上了」,这类问题不会被发现。
上云前的四个判断
| 判断 | 通过标准 | 不通过时的表现 |
|---|---|---|
| 宿主有没有真机证据 | 落在有 158 格实测的三个宿主里,或自己补一轮实测 | 文档说支持,实际工具列表为空 |
| transport 是不是 stdio | 明确知道谁 spawn、包从哪来、stdout 有没有脏输出 | 进程起来但握手失败 |
| 出站是否够用 | registry 与目标 API 都在白名单内,回环不走代理 | 冷启动超时、调用全超时 |
| 凭据与工具权限是否收敛 | 配置里无明文凭据,写工具需人工确认 | 仓库泄露 token、无人值守进程可写 |
这四条里任何一条没过,都不建议直接放进生产。矩阵的分布也支持这个保守态度:2,737 格里 pass 1,438 格(52.5%),fail 873 格(31.9%),na 367 格(13.4%),limited 59 格(2.2%)。三分之一的格子是失败的,而全部结论里还有 49.1% 只是文档推断。
总结
云上跑 MCP 的难点不在协议本身,而在把「本地父子进程」这套假设搬进无人值守环境时,每一层都要重新交代清楚;参考 精选插件 Top 榜 里各插件标注的传输方式,能少走一半弯路。先定宿主、再定包来源、最后收权限,顺序反了就会反复返工。
适合与不适合
适合:要把 MCP 接进无人值守流水线的团队;已有命令行宿主、准备迁到云主机的场景;内网环境需要固定版本与固定出站策略的部署;愿意先小范围实测再放量的团队。
不适合:只想装上就能用的人——矩阵里 31.9% 的格是 fail,49.1% 的结论来自文档推断;需要绝对确定性的人——真机结论只覆盖 3 个宿主,其余 12 个宿主的结论不能当实测用;用 codebuddy 或 opencode 的人——本次采集里这两个宿主是 161 格全 na,任何「能用」的说法都缺证据。
标签:MCP、DeepSeek Harness、云上部署
本文由 DeepSeek Harness Hub 自动整理,数据来源于插件详情页。