当日发布与版本定位

langchain-ai 的官方 Release 记录与 GitHub API 同步显示,langchain==1.4.0 于 2026-09-03T16:59:53Z(北京时间 2026-09-04 00:59:53)正式发布,tag 为 langchain==1.4.0,非预发布,target 为 79cab2d 提交。该版本为 1.4.x 系列首个稳定版,距离上次预发布 1.4.0a3 仅约两日,标志着 langchain.mcp 相关能力从 alpha 进入稳定可用阶段。对比 1.3.18 稳定线,本次为增量特性发布,未引入对核心链式调用的破坏性变更,确认为 Asia/Shanghai 2026-09-04 00:00–23:59 窗口内的新实质进展,非旧闻刷新或转载。

关键变化

核心新增为 langchain.mcp 命名空间与 MCPAdapter。MCPAdapter 将任意 MCP 服务(通过 URL、本地脚本、进程内 FastMCP 服务、MCP JSON 多服务配置或外部自建客户端)转换为 LangChain 工具对象,可直接传入 create_agent。与 1.4.0a3 相比,稳定版固化了适配器的单入口自动推断、服务名前缀隔离与多服务舰队支持,并配套提供可运行的 docs 示例,便于中国团队快速验证多 MCP 编排。

配套优化包括:perf(anthropic,langchain) 在中间件中省略追踪输入,减少 LangSmith 等可观测平台的冗余写入;fix(langchain) 修正 Agent 工具路由中对模型目标的包含逻辑,避免工具被错误路由到非预期模型;chore 将 vcrpy 测试依赖下限提升至 8.2.0,保障录制回放测试的稳定性。其余多为文档与测试相关提交,未涉及运行时核心行为变更。

适用对象与价值

适合已使用 LangChain 构建 Agent、或需同时编排多个 MCP 服务的中国开发者与团队。尤其利于需要统一凭证管理、超时隔离或按服务前缀审计的场景,例如将企业内部检索、工单、数据库等 MCP 服务一键接入智能体。对于仅使用基础链式调用、提示模板与输出解析的用户,可按需暂缓升级,但新项目建议直接采用 1.4.0 以获得稳定的 MCP 能力。

兼容性与迁移条件

  • 仓库与许可:由 langchain-ai 维护,仓库 https://github.com/langchain-ai/langchain,LICENSE 当日核验仍为 MIT,允许商用与二次分发,需保留版权与许可声明。
  • 兼容性:与 1.3.18 及 1.4.0a 系列保持兼容,新增能力位于 langchain.mcp 独立命名空间,现有 Chain、Agent 与 Tool 调用无需改动;依赖要求 fastmcp >=4.0.0,启用 MCP 需安装可选依赖 pip install langchain[mcp]。
  • 安装与访问:可通过 PyPI 拉取稳定包 pip install -U langchain==1.4.0 或 uv add langchain==1.4.0,需公网访问 GitHub 与 PyPI;内网环境需提前同步轮子包 langchain-1.4.0-py3-none-any.whl 与源码包,中国镜像可按需配置。

限制与验证建议

限制:MCP 能力仍依赖外部 MCP 服务的可用性与协议一致性,服务端实现差异可能影响工具发现与调用稳定性;多服务共享单一协议 era 时,最旧后端决定整体 era,混合版本服务建议拆分为独立适配器验证。当前变更未涉及安全修复与许可证调整,不产生额外合规负担。

建议在预发环境完成三项验证:1)单服务与多服务 MCP 发现与工具调用的可达性;2)服务名前缀隔离与 metadata.mcp 分组读取的正确性;3)在目标 Python 3.10+ 与 Linux/macOS/Windows 环境的安装与基本 Agent 流程回归,确认无异常后再升级生产。

来源时效说明

关键事实由上海当日 2026-09-04 的官方 Release 页面(langchain==1.4.0 变更与 tag)、GitHub API 发布记录(published_at 2026-09-03T16:59:53Z,换算为上海 2026-09-04 00:59:53)及 LICENSE 页面共同支撑,均已核验落于 Asia/Shanghai 00:00–23:59 窗口;未为补充背景抓取往日页面,必要背景来自当日来源与站内已核验资料。