开源LangChain Releases·2026年9月5日

LangChain发布langchain.mcp Alpha预览:MCP服务器可直连create_agent

LangChain 1.4.0a2引入首个官方MCP适配器MCPAdapter,将任意MCP服务器转为LangChain工具,连接处理复用FastMCP,支持多服务器及新旧协议。

AI解读:LangChain 1.4.0a2这个alpha预览要解决的是:MCP(模型上下文协议)服务器越来越多,但接入LangChain agent一直需要自己写胶水代码。现在官方提供了一个MCPAdapter,直接把MCP服务器变成create_agent可用的工具,连接逻辑复用FastMCP的客户端实现,不用重复造轮子。对开发者的直接影响是:只要用法是pip install "langchain[mcp]==1.4.0a2",就能用MCPAdapter把远程URL、本地脚本、进程内FastMCP服务器或多个服务器配置变成工具列表,get_tools() 返回的工具在async with块结束后仍可用。还要注意,这是alpha版本,API在 1.4.0 正式版前可能变化。对需要同时接多个MCP服务的团队,多服务器配置会自动加命名空间前缀避免工具名冲突,但有个限制:多服务器配置会让所有后端协议对齐到最老的那个时代,所以如果要让现代服务器走新的streamable HTTP,就得把旧服务器单独放在另一个适配器里。这个版本最值得测试的是它的elicitation功能:让服务器在调用中向人类提问,通过LangGraph的interrupt机制实现,但它是可选的,因为声明后agent必须有人类反馈路径才能遵守承诺。

LangChain 1.4.0a2发布了langchain.mcp的alpha预览。它是一方适配器,能把任意MCP服务器变成可传给create_agent的LangChain工具。连接处理复用FastMCP的实现,客户端功能原样可用,没有在更窄的接口后重新实现。安装命令为pip install "langchain[mcp]==1.4.0a2"。

MCPAdapter的连接目标与用法

MCPAdapter接受任何fastmcp.Client能接受的目标:URL、本地脚本路径(经stdio启动)、进程内FastMCP服务器、同时命名多个服务器的配置,或你自己构建的fastmcp.Client。传输方式自动推断,因此只有一个入口点,而不是每个协议一个。

get_tools() 返回的工具持有适配器的客户端,在上下文退出后仍可调用——async with块界定的是发现(discovery)范围,不是工具生命周期。

认证、缓存、超时与多服务器

MCPAdapter接受两个参数:目标(target)和elicitation。FastMCP支持的其他功能在你自己构建并作为目标传入的fastmcp.Client上配置。认证可接受 "oauth" 运行OAuth流、token字符串或httpx.Auth实例;缓存默认关闭,cache=True可选开启并尊重服务器的ttlMs和cacheScope提示;超时、日志和处理器等均沿用fastmcp.Client行为。

当适配器指向多服务器配置时,它通过一个连接并发连接所有服务器,向agent展示单一工具列表。多个服务器时工具按服务器名加命名空间前缀(如weather_get_forecast、calendar_create_event),避免冲突;单服务器时直接连接且工具名无前缀。配置遵循FastMCP的MCP JSON schema。

新旧协议并存与多适配器并发

MCP已从initialize握手转向server/discover,现网服务器两个时代并存。FastMCP按连接协商时代,适配器无需选择。多服务器配置暴露单一时代,其最旧的后端决定整个集合的时代;混入握手时代服务器会拉低现代后端,但功能仍可用,只是时代限定的功能失效。集成测试覆盖了两种时代服务器同时调用。

工具结果与elicitation中断

每个工具是异步的。MCP工具运行后报告失败时返回status="error" 的ToolMessage,携带服务器错误文本;传输失败或不可转换内容则抛出异常。结构化输出随工具消息的artifact传递。

elicitation为可选项(elicitation="interrupt"),启用后服务器请求通过LangGraph中断呈现,人类在审核agent工作时也能回答。请求按mode区分:"form" 携带request_schema,"url" 提供人类访问的地址;答案按action区分:"accept"、"decline" 或 "cancel"。这需要检查点(checkpointer)。

信息来源

LangChain Releases原始来源