在 MCP 的文档里反复出现一句话:"本地 Server 走 stdio 传输"。翻进任何一本操作系统教材,stdio 又是最基础的第一课。这个缩写读作"标准输入输出"(standard input/output),是每个进程一出生就自带的三根管子——它朴素到被当作常识,却是管道、重定向、进程间通信、MCP 本地传输共同的地基。
本文从三个标准流讲起,过一遍管道与重定向的日常用法,看程序怎么读写它,最后回到那个问题:MCP 为什么用它做本地传输。
1、三个标准流
操作系统启动一个进程时,会默认替它打开三个数据通道,这就是标准流。它们不是文件,却像文件一样可读写,各有一个编号(文件描述符)与默认去向:
| 通道 | 名称 | 描述符 | 默认连接 | 用途 |
|---|---|---|---|---|
| 标准输入 | stdin | 0 | 键盘 | 程序读进来的数据 |
| 标准输出 | stdout | 1 | 屏幕 | 程序的正常产出 |
| 标准错误 | stderr | 2 | 屏幕 | 程序的错误与日志 |
三个通道各司其职,其中 stdout 与 stderr 分开是最容易被低估的设计:正常结果与报错信息走不同的管子,就能分别接管——结果存文件、报错进日志,互不污染。ls 找得到文件时输出走 stdout,找不到时的报错走 stderr,一屏混着显示,底下却是两条独立通路。
编号 0、1、2 也不是随便排的:进程每打开一个文件就领一个描述符,标准流作为"出厂自带"的三个,把最前面的号码占了,之后打开的文件才从 3 开始。这是 Unix"一切皆文件"设计的第一批居民——键盘、屏幕、磁盘文件、设备在内核眼里都是可读写的数据通道,标准流只是其中默认接着的那三根。
2、管道与重定向
标准流的威力在于可以换接管子。重定向改变通道的落点:> 把 stdout 写进文件,< 让 stdin 读文件,2> 单独接走 stderr,2>&1 把两条流并成一条。管道则把一个进程的 stdout 直接接到下一个进程的 stdin,用竖线串联:
cat access.log | grep "500" | sort | uniq -c
一行命令里四个进程接力:cat 吐出全文,grep 滤出含 500 的行,sort 排序,uniq -c 计数——数据像水流过一节节管子。管道的数据通路如下:
图中每个进程只认自己的 stdin 与 stdout,谁在生产、谁在消费、中间接了几个环节,程序自身毫无感知——这就是 Unix 哲学的原点:每个程序做好一件小事,通过标准流协作完成大事。而把两个流并到黑洞的写法是日常静音神器:
python server.py > /dev/null 2>&1
正常输出与报错全部丢弃,进程安静运行——/dev/null 是一个"写进去就消失"的特殊设备。重定向家族的常用写法速查如下:
| 写法 | 含义 |
|---|---|
> |
stdout 写入文件(覆盖) |
>> |
stdout 追加到文件 |
< |
文件作为 stdin 读入 |
2> |
stderr 单独写入文件 |
2>&1 |
stderr 并入 stdout |
表中五种写法可以组合使用:cmd > out.log 2>&1 先把 stdout 指到文件、再让 stderr 跟过去,两条流就汇进了同一个文件。
3、程序怎么读写
任何语言的标准库都直接站在三个流上。Python 里最常见的 print 与 input,本质就是写 stdout、读 stdin;需要精细控制时用 sys 模块的流对象。一个逐行读取、原样加前缀回写的程序只要几行:
import sys
for line in sys.stdin: # 逐行读标准输入
sys.stdout.write(f"echo: {line}")
把它存成 echo.py,命令行里 echo 你好 | python echo.py 就能看到回声。很多经典工具就是这样一个"从 stdin 读、往 stdout 写"的纯函数式过滤器——输入从哪来、输出到哪去,完全由调用方的管子决定,程序自己不关心。流对象的完整接口见 Python sys 模块文档。
还有一个隐形角色:EOF(流结束)。for line in sys.stdin 的循环什么时候停?答案是 stdin 关闭的那一刻——终端里按 Ctrl+D 手动关闭,管道场景里上游进程退出即自动关闭。第 5 节要讲的"MCP Server 崩了 Host 立刻感知",靠的正是这个机制:流一关,读循环自然结束,事件就这么传播过来。
4、MCP 为什么选它
4.1、本地传输的约定
MCP 的本地形态是这样的:Host 把 MCP Server 作为子进程拉起,双方不做任何网络配置,Server 的 stdin 归 Host 写、stdout 归 Host 读——两个进程之间架起一条纯本地的双向通道。报文就是 JSON-RPC 消息,一行一条:
(Host 写入 Server 的 stdin)
{"jsonrpc": "2.0", "method": "tools/list", "id": 1}
(Server 从自己的 stdout 回给 Host)
{"jsonrpc": "2.0", "id": 1, "result": {"tools": [...]}}
选 stdio 而不是本地端口,收益有三:不占端口、不碰网络栈,本机怎么跑都不会端口冲突;不经过网络,数据不出机器,权限边界就是进程权限;调试极简,终端里手工敲一行消息发给进程就能测。规范细则见 MCP 官方文档。
4.2、日志必须走 stderr
stdio 传输带来一条对等的纪律:stdout 从此是协议专线。Server 想打日志、报调试信息,必须写到 stderr——一旦有半行日志混进 stdout,Host 读到的就不是合法 JSON-RPC,连接直接报废。这正好用上了第 1 节的分流设计:stdout 承载协议、stderr 承载诊断,两条流在同一进程里并行不悖。标准流的完整定义与历史可参考 维基百科条目。
5、三个高频坑
其一,缓冲把数据扣住了。stdout 接终端时按行刷新,接管道时变成按块缓冲——几十行输出可能滞留在缓冲区里,下游迟迟等不到。长跑的 Server 必须在每条消息后显式 flush(Python 的 print(..., flush=True) 或以行缓冲模式启动),否则 Host 会看起来"卡死"。
其二,忘了换行的分量。stdio 传输的消息以换行符定界,输出时若漏掉行尾换行、或消息体内部混入裸换行,对端的读循环立刻错位。CRLF 更是隐蔽杀手:Windows 文本模式的 \r\n 会让 JSON 解析莫名失败,务必以二进制心态对待每一行。
其三,进程退出就是断连。stdio 通道的生命周期与进程绑定:Host 退出时子进程随之终结,Server 崩了 Host 立即感知到流关闭。这既是优点(连接状态零管理)也是约束(没有重连一说,进程死了只能重新拉起)——设计断线恢复时,别按网络协议的思路找"重连",重启子进程才是正解。
6、总结
回顾全文:三个标准流是进程自带的输入、输出、报错通道,重定向换落点、管道串进程,构成 Unix 工具协作的根基;MCP 选它做本地传输,换来零端口、零网络、零配置的纯本地通道,代价是 stdout 成为协议专线、日志必须改走 stderr,缓冲与换行是两个最常踩的坑。对于写本地工具或 MCP Server 的开发者,建议把"stdout 只出协议、stderr 只出日志、每条消息 flush"当成肌肉记忆——三根管子用对了,进程间的协作就干净了一半。


