@ai-sdk/mcp@0.0.36 发布：修复 stdio 传输环境变量问题

Vercel 旗下的 AI SDK 生态迎来一次针对 MCP（Model Context Protocol）模块的补丁更新——@ai-sdk/mcp@0.0.36。这是一次典型的 patch 级别修复，虽然版本号变化不大，但对依赖 stdio 传输方式的开发者来说，解决了一个实际影响运行时行为的问题。

本次更新的核心内容

根据 GitHub Release 页面记录，该版本由 github-actions 于 9 月 25 日发布，属于 vercel/ai 仓库主分支下的一次经过 GitHub 官方 GPG 签名验证的提交（GPG Key ID: B5690EEEBB952194）。

更新日志中列出的唯一变更是一条 Patch Change：

fix(mcp): preserve explicit stdio transport environment values（修复：保留显式设置的 stdio 传输环境变量）

这意味着在此前的版本中，当开发者通过 stdio 传输方式启动 MCP 服务时，显式传入的环境变量可能未被正确保留或覆盖。本次修复确保了这些环境值能够按预期传递给子进程。

MCP（Model Context Protocol）由 Anthropic 于 2024 年底提出并开源，旨在为大语言模型提供一套标准化的「工具调用与上下文获取」接口规范，类似于 AI 领域的 USB-C 协议——让模型能够以统一方式连接文件系统、数据库、浏览器自动化、外部 API 等各类工具。Vercel AI SDK 通过 @ai-sdk/mcp 包实现了对该协议客户端侧的封装，使开发者可以在 Next.js、Node.js 等环境中直接调用符合 MCP 规范的工具服务器，而无需手动处理底层的协议细节和进程管理。由于 MCP 生态仍在快速成型阶段，各主流 AI SDK 对其的支持均处于密集迭代期，基础可靠性类补丁（如本次的环境变量修复）是早期版本中最常见也最关键的更新类型。

为什么 stdio 传输的环境变量很重要

MCP（Model Context Protocol）是一种用于连接 AI 模型与外部工具、数据源的协议。在实际部署中，stdio 传输是最常见的通信方式之一——它通过标准输入/输出与本地启动的子进程通信。

在这种模式下，环境变量往往承载着关键配置，例如 API 密钥、认证 token、运行路径或调试开关。如果 SDK 在启动子进程时没有正确保留开发者显式指定的环境变量，就可能导致子进程读取到错误或缺失的配置，进而引发认证失败、连接异常等难以排查的问题。

本次 0.0.36 版本的修复正是针对这一场景，确保「显式设置」的环境值不会在传输过程中被丢弃或意外重置。

stdio 传输（Standard Input/Output Transport）是一种进程间通信机制，父进程通过写入子进程的 stdin 来发送请求，并从子进程的 stdout 读取响应。与基于 HTTP 或 WebSocket 的网络传输不同，stdio 方式无需开启网络端口，天然适合在本地沙箱中运行不受信任的工具进程，安全隔离性更好。在 MCP 的架构中，宿主应用（如 AI 助手或 IDE 插件）通常以 stdio 方式拉起一个本地 MCP Server 进程，双方按照协议格式交换 JSON-RPC 消息。子进程的运行环境完全由父进程在 spawn 或 fork 时通过 env 参数注入，若 SDK 在这一步出现合并逻辑错误（例如用系统默认环境覆盖了开发者显式传入的值），子进程便会在一个"残缺"的环境中启动，而错误现象往往只表现为认证失败或功能异常，极难定位到根因。

对开发者的实际影响

对于正在使用 AI SDK 集成 MCP 工具链的团队，这是一次建议尽快跟进的补丁更新。如果你在使用 stdio transport 时遇到过环境变量「设了却不生效」的诡异现象，升级到该版本很可能直接解决问题。

从版本号（0.0.x）可以看出，@ai-sdk/mcp 目前仍处于早期迭代阶段，API 与行为可能随版本快速演进。建议开发者在生产环境中锁定明确的版本号，并在升级前查阅完整的 changelog。

值得关注的是，vercel/ai 仓库本身拥有超过 27k Star 和 5.2k Fork，主分支已累计超过 4300 次提交，说明该 SDK 生态活跃度极高，MCP 相关模块也在持续快速完善中。

小结

@ai-sdk/mcp@0.0.36 是一次范围明确、目标清晰的补丁发布。虽然改动只有一行修复说明，但对依赖 stdio 传输的 MCP 应用而言，环境变量的正确传递直接关系到服务能否稳定运行。处于早期版本阶段的模块尤其需要这类基础可靠性修复，也从侧面反映出 AI SDK 团队对 MCP 生态的持续投入。