LangChain 发布 1.4.0a3：新增 langchain.mcp 一键将 MCP 服务转为 Agent 工具

LangChain 于 2026-09-02（Asia/Shanghai）发布 1.4.0a3 预览版，核心是全新的 langchain.mcp 适配层。该版本由 LangChain AI 组织在 GitHub 官方仓库 langchain-ai/langchain 发布，采用 MIT 许可，发布时间为 2026-09-01T17:19:30Z（对应北京时间 2026-09-02 01:19:30），已在当日 Release 页面与 API 中核验。该功能将任意 MCP（Model Context Protocol）服务直接转为 LangChain 工具，交由 create_agent 使用，面向构建 Agent 与工具调用的中国开发者与企业团队提供更简洁的集成路径。

关键变化

• 1）MCPAdapter 统一入口：接收任意 fastmcp.Client 接受的目标——URL、本地脚本路径（stdio 拉起）、进程内 FastMCP 服务、多服务器 MCPConfig 或已构建的 Client，甚至 ClientGroup 舰队，传输方式自动推断。 2）list_tools 与缓存：MCPAdapter.list_tools(*, cache_mode="use") 支持客户端缓存，use 在 TTL 内命中缓存、refresh 刷新、Bypass 跳过，符合 SEP-2549。 3）单工具转换：as_langchain_tool(tool, client, *, elicitation=None) 便于自行管理 Client 的调用方。 4）元数据分组：工具的 annotations（snake_case）与 _meta 归入 metadata["mcp"]["tool"]，服务身份归入 metadata["mcp"]["server"]，便于审计与排障。 5）人机协同：elicitation="interrupt" 将服务端中途提问通过 LangGraph interrupt 暴露，人类回答后以 Command(resume=answer) 恢复执行，需配合 checkpointer。

适用对象与访问条件

面向使用 LangChain / LangGraph 构建 Agent、需对接 MCP 生态（天气、日历、数据库、内部服务等）的开发者。仓库地址 https://github.com/langchain-ai/langchain ，本次发布页面 https://github.com/langchain-ai/langchain/releases/tag/langchain%3D%3D1.4.0a3 。安装需 Python 3.10+，执行 pip install --pre "langchain==1.4.0a3" 获取预览版；使用 MCP 能力需额外安装 pip install "langchain[mcp]" 并满足 fastmcp>=4.0.0。示例：async with MCPAdapter("https://example.com/mcp") as adapter: agent = create_agent("anthropic:claude-sonnet-5", await adapter.list_tools())。

兼容性与迁移

1.4.0a3 为 1.4.0 线的第三个 alpha，标记为 pre-release，非稳定版，接口在 1.4.0 正式版前可能调整。依赖 fastmcp 的连接、鉴权、缓存与处理器能力，MCPAdapter 直接透传 fastmcp.Client 配置，行为与 FastMCP 保持一致，不做二次封装限制。单服务器时工具名不加前缀，多服务器时按服务器名命名空间化（如 weather_get_forecast），分子服务凭据隔离。已使用 1.4.0a2 的用户可直接升级，关注 list_tools 缓存参数与元数据分组的变化；生产环境建议在隔离环境验证后再全量升级。

限制与后续步骤

当前为 alpha 预览，官方说明接口可能在 1.4.0 正式版前变动，不建议直接用于生产关键路径。elicitation 需要 LangGraph checkpointer 才能中断与恢复；多服务器配置下，协议时代由最旧后端决定，混用 handshake 与 server/discover 时代的服务需分开适配器以保留现代特性。未涉及许可证变更（仍为 MIT）与安全修复。下一步可参考 FastMCP 客户端文档、传输与 Elicitation 说明，在测试环境验证目标 MCP 服务的连接、鉴权与工具转换效果，并关注后续正式版发布说明。