搜「MCP和LangChain有哪些」的人,多半已经看过两边的介绍,但真动手时还是卡住:工具写在哪、循环谁来跑、换模型要不要动框架。这篇不罗列清单,而是把两边各自的职责摆开,给你一份能照着走的判断顺序,顺便说清哪些情况下这套划分并不适用。
先把两层摆正:一个是接口约定,一个是写代码的框架
这两样东西老被放在一起问「有哪些」,其实问错了方向。MCP 管的是工具长什么样、怎么被认出来、怎么被叫起来,它不关心是谁在叫。LangChain 管的是叫的顺序、上下文怎么拼、失败了怎么重试、状态放哪。一个是插座标准,一个是会用电器的流程编排。你说哪个更高级?没法比。
- MCP
- 一份接口约定:把工具的能力、输入输出、怎么发现写清楚,任何客户端按这份约定都能接上,跟调用方是脚本还是 Agent 无关。
- LangChain
- 一套写代码的组织方式:谁来调、先调哪个、中间结果怎么塞回上下文、出错重试几次、会话状态存哪,这些都由它来编排。
装反了长什么样?我见过两种典型。一种是把工具描述整段抄进系统提示词里,让模型自己「记住」有哪些工具——这不是 MCP 干的事,MCP 要的是工具能被结构化地列出来、按参数调用,描述写在提示词里既占上下文又容易漂。另一种更隐蔽:在工具函数内部自己写了个循环,反复调模型直到出结果。工具就该干一件事、返回一个结果,循环属于编排层,塞进工具里之后超时、重试、日志全乱套。
| 你手上的活儿 | 该归哪层 | 放错了会怎样 |
|---|---|---|
| 定义工具名、参数、返回值 | MCP 的接口约定 | 模型看不懂参数,调用老报错 |
| 决定先查资料还是先算数 | LangChain 的编排 | 流程写死在工具里,换个任务就得重写 |
| 工具被发现和列出 | MCP | 靠提示词硬塞,上下文被占满 |
| 失败后重试几次、状态存哪 | LangChain | 重试逻辑散在工具内,超时难排查 |
判断标准其实很简单:问一句「这段东西换一个调用方还成立吗」。工具的描述、参数格式,换个客户端照样能用,那就是接口约定层的事。而「先调 A 再调 B、B 失败了退回 A」这种顺序,换一个任务就不成立了,那是编排层的事。拿这条线去切,基本不会切错。
- 翻出你的工具定义看有没有把「什么时候该用我」这种话写进工具描述里。工具描述只写能做什么、参数是什么,使用时机交给编排层判断。
- 检查工具函数体搜索函数里有没有调模型、有没有 while 循环。有就说明编排漏进了工具,把循环提到外层调用方。
- 对着调用链画一遍把「谁发现工具、谁决定顺序、谁处理失败」三件事各写一行,看是不是落在了两层里。三项挤在同一处,就是职责没分开。
MCP 这一侧到底给你什么
先别急着把 MCP 当成「又一个框架」。它更像一份约定:工具叫什么名字、干什么用、要哪些参数、参数是什么类型,都用一套固定格式写清楚。客户端照着这份描述去渲染表单、拼请求,模型照着这份描述判断该不该调、怎么填。两边读的是同一份东西,所以不容易对不上。
实际用下来,这一侧的收益不在「多聪明」,而在「省掉反复对接」。以前每接一个外部能力,你得在应用里手写一层包装,字段名、参数校验、错误返回各写一遍;有了这套描述,工具方按格式交作业,客户端按格式收作业,中间那层胶水薄了很多。代价是格式本身有约束,工具能力太怪、参数结构太绕的时候,描述会写得别扭,这时候硬套反而比直接写代码麻烦。
| 传输方式 | 谁在跑 | 成本落在谁身上 |
|---|---|---|
| 本地进程起 | 工具进程和应用跑在同一台机器上 | 部署、升级、依赖冲突都归你管;好处是延迟低、不用过网 |
| 走网络 | 工具在远端服务上,应用通过连接去调 | 运维归服务方,你只管连得上;代价是多一层网络和鉴权,断连要处理 |
选本地还是走网络,别只看「哪个快」。团队小、工具就一两个、又都跟应用同机部署,本地进程省事;一旦工具要跨团队共用、或者要碰只有服务端才有的资源,走网络更现实。反过来说,如果工具依赖一堆本机环境变量和本地文件,硬搬到远端,头一周基本都在调环境。
还有一层常被忽略:边界。工具跑在谁的机器上,就决定了它能碰哪些资源。跑在本地,它读的是你这台机器的文件、用的是你当前用户的权限;跑在远端,它只能碰服务方开放给你的那部分。写配置的时候心里得有这张图,不然很容易出现「本地测试好好的,一挪到远端就报没权限」。
- 工具描述里参数写全,尤其是必填项和取值范围,别指望模型猜
- 本地进程那条路,先把依赖和版本钉死,别让工具和应用抢同一个包
- 走网络那条路,先确认断连、超时、重试怎么处理,再谈功能
- 不管哪种方式,先问清楚这个工具会读哪些资源、写哪些资源
- 权限给到够用就行,别图省事直接给最大范围
LangChain 这一侧到底给你什么
很多人把 LangChain 当成「一个能调模型的库」,这个理解太窄,也容易跟 MCP 撞车。它真正解决的是另一件事:把「模型说一句话、你解析、你去执行、再把结果喂回去」这个循环,写成一段别人接手也能看懂的代码。这件事听着不性感,但一个流程超过三步、要处理异常、要加日志的时候,手搓就开始疼了。
举个通用场景。一家 5 人小团队要做个内部问答工具,先接一家模型,过阵子老板说换另一家试试。要是每处调用都写死了厂商参数,换一次就得翻遍全项目改 URL、改鉴权、改返回结构。LangChain 那层统一接入的价值就在这儿:改动收敛到一处,业务代码基本不动。至于具体支持哪些厂商、哪些参数对不上,别听谁复述,到 站内模型资料库(/models) 按当时的表格核对。
| 你手上要干的事 | LangChain 侧能接住的 | 别指望它替你做的 |
|---|---|---|
| 调模型、切厂商 | 统一接入层,参数和返回结构收口 | 帮你判断哪家划算、哪家稳 |
| 循环里解析和回喂 | 把多步流程串成可读的链式结构 | 自动猜到模型下一步想干嘛 |
| 记上下文、做检索 | 记忆、检索、回调这些周边件现成可用 | 替你设计知识库怎么切、怎么更新 |
| 出错要排查 | 回调能挂日志和追踪 | 帮你定位到底是模型还是网络的问题 |
记忆、检索、回调这几样,是它省事最多的地方。自己粘一遍也能跑,但粘出来的东西通常散在四五个文件里,谁改谁心虚。它给的是一套约定好的接口,你按约定填内容就行。代价是抽象层多了,出问题时你得知道错误被包在哪一层。所以我不建议一上来就全套装上,先跑通最短那条路。
- 先打通单次调用只接一家模型,跑通「发一句话、拿到回复」,确认鉴权和参数填在了正确的那一格,别在这步就引入记忆和检索。
- 再把循环显式写出来让模型输出结构化内容,你来解析、执行、回喂。验证办法:故意给一个格式不对的返回,看你的代码是报错还是静默吞掉。
- 最后才挂周边件记忆、检索、回调一件一件加,每加一件就重跑一次上面的异常用例。加完发现错误定位变难了,说明这层抽象你还没吃透,先退回去。
判断顺序:按这四问走,别按热度走
别急着看哪个火。先拿自己手上的活儿过四道问,答案会直接告诉你该往哪边放东西。这四问的顺序有讲究,从「谁用」问到「谁改」,越往后越接近组织问题,也越容易被忽略。
| 问题 | 回答偏向 | 倾向的落点 |
|---|---|---|
| 这套工具只服务当前这一个应用吗 | 是 | 先写在应用里,别急着拆成独立服务 |
| 有别的客户端也要用同一套工具吗 | 是 | 值得单独立成 MCP 服务 |
| 流程里有需要人确认、或按结果分岔的环节吗 | 有 | 需要一层编排,光有工具不够 |
| 工具作者和业务开发者是同一拨人吗 | 不是 | 协议层的收益最大,边界也最值钱 |
第一问最容易答错。很多人一上来就想「做成服务显得正规」,结果只有一个客户端在调,多出来的进程、鉴权、部署全成了维护负担。判断标准很土:除了当前这个应用,还有没有第二个调用方,哪怕是团队里另一个小脚本。有,才谈得上拆出去共用;没有,就老实写在应用内部,等第二个调用方真的出现再搬。
- 先列调用方把现在和三个月内可能调用这套工具的程序列出来,只有当前应用一个,就先不拆服务。验证方式:问一句「谁会来连它」,答不出第二个名字就停。
- 再找人工卡点顺着流程走一遍,标出需要人点确认、看结果再决定下一步的位置。这类分支一旦超过一处,说明缺的是编排而不是工具,工具本身解决不了顺序和状态。
- 最后看人问清楚工具是谁写的、业务逻辑是谁改的。两拨人分开时,协议层的价值才真正体现,因为接口把变更挡在了两边。
第三问的坑在于把「多轮」当成「多步」。一个流程固定跑三步、每步参数都确定,那不叫需要编排,写死就行。真正需要编排层的是那种结果不确定、要根据上一步输出决定下一步走哪条路、中间还可能停下来等人的情况。这时候工具只是手,缺的是决定先伸哪只手的脑子。
第四问最现实。工具作者和业务开发者如果是同一拨人,加个接口改个参数顺手就做了,协议层带来的隔离收益不明显,反而多一层调试成本。反过来,工具由平台或基础组维护、业务方天天改流程,那一层约定就值钱了。这套判断不适用于小到一个人全包的团队,那种情况下怎么顺手怎么来,别为了架构好看给自己加活。
几个具体的装错动作
先说结论:头一周最容易犯的错,不是不会用,是把手上的东西放错了地方。工具描述本该是 MCP 那边的事,编排和重试本该是客户端或框架那边的事,一装反,后面拧都拧不回来。
| 你干的动作 | 看着像什么 | 实际该归谁 |
|---|---|---|
| 把工具清单整段写进系统提示词 | 省事,模型直接看到全部能力 | MCP 的工具描述,由服务端声明 |
| 在 MCP 服务里写重试和 if/else 分支 | 像是把服务做得更稳 | 客户端或编排层,服务只负责把一件事做对 |
| 为了用上框架硬套一层 LangChain | 感觉结构清晰了 | 只有确实需要串联多步时才引入,不然就是多一层黑箱 |
第一件事最典型。图快,把十几个工具的名字、参数、什么时候用,全塞进系统提示词里。当时那个模型能跑通,换一个就乱了,因为它对这段长文本的注意力分配不一样。排查时你会以为是提示词没写好,其实根子在工具描述该由 MCP 服务端自己声明,客户端去拉取,模型换了也只是换了消费者,描述没动。判断标准很简单:这段工具说明换模型后要不要改?要改,就说明它放错了格。
- 工具的名字、参数、边界写进 MCP 服务的工具描述里,别复制进提示词
- 系统提示词只留角色、口吻、禁止事项这类不随模型变的东西
- 换模型后先跑一遍工具调用,看是描述没被读懂,还是模型本身能力不够
- 发现某个工具总被误调,先改描述里的适用范围,别急着加提示词补丁
第二件,在 MCP 服务里写重试和分支判断。写法上很自然:调不通就重试三次,参数缺了就走另一条路。可这套逻辑是嵌在服务里的,换一个客户端,客户端自己也有重试策略,两边一叠加,你根本数不清一次请求到底发了几遍。更麻烦的是迁移时逻辑搬不动,因为它跟服务的实现绑死了。实际用下来,服务端只该保证「给我明确的输入,我给你明确的结果」,重试、降级、分支判断放在调用方。
- 先分清服务边界翻一遍 MCP 服务的代码,把所有 for 重试、超时兜底、if 分支圈出来,问一句:这段逻辑换客户端还要不要?要,就往上挪。
- 把编排放回客户端客户端或框架层负责决定调哪个工具、失败怎么办、要不要换路径,服务端只负责单次执行。
- 换客户端验证一次换一个支持 MCP 的客户端连同一个服务,看行为是否一致;不一致,说明还有逻辑埋在服务里。
第三件是引入 LangChain 的时机。有人只是想让一个模型调一个工具,也顺手装了框架,结果一层封装套一层,报错信息从底层模型一路往上裹,最后看到的那句根本不知道是哪一层抛的。排查时最耗时间的不是修,是定位。什么情况下不适用:你的流程就是单次问答加一两个工具调用,那就别装框架,直连 API 反而干净;只有当你要串联多步、需要状态管理、或者团队里多人协作同一套编排时,引入才划算。到 指南中心(/guides) 翻一翻选型那几篇,先确认自己处在哪种情况。
头一周照着做的落地顺序
别急着两边同时开工。头一周最省事的路径是:先把一个工具从定义到返回完整跑通一次,确认参数名、类型、必填项、返回结构跟你预期一致,再谈编排怎么串。实际用下来,翻车最多的不是编排写错,是底层工具返回的字段跟脑子里想的不一样,编排层跟着一起错,排查时两头对不上号。
- 挑一个最简单的工具跑通选一个入参少、返回结构扁平的只读工具,比如查时间或查固定表。手动发一次调用,把请求参数和原始返回原样贴进一个临时文件,别用日志打印后的美化版,要看真实的字段名和嵌套层级。验证标准:你能指着返回说清哪个字段对应你要的结果,多一层嵌套都不行。
- 把工具定义冻结成一份把这份工具的名称、描述、参数结构、返回结构整理成一份独立文件,放在改动最少的位置,编排层只引用不复制。验证标准:编排代码里搜不到第二份参数定义,改一处只有一处变。
- 只动一层,改完立刻回放每次改动只碰工具层或编排层其中一边,改完用同一组输入重跑一遍,对比输出差异落在哪个字段。验证标准:差异能定位到具体一层;如果两层的输出都变了,说明上一轮冻结没做干净,先回去收口。
| 现象 | 先查哪一层 | 怎么判定 |
|---|---|---|
| 返回字段缺失或多嵌套 | 工具层 | 拿原始返回跟定义文件逐字段对,不看编排日志 |
| 参数校验报错但定义看着没错 | 工具层 | 检查必填项和类型,注意数字与字符串混填 |
| 流程分支走错 | 编排层 | 工具输出正常的前提下,才看条件判断和上下文传递 |
| 改完一处两边行为都变 | 冻结没做好 | 搜编排里有没有重复定义的参数结构 |
这套顺序不适用的情况也说清楚:工具本身依赖外部状态、每次返回都不一样时,回放对比要盯住结构而不是值,别拿两次不同的数值当 bug。另外,如果你手上已经有稳定跑通的工具,直接进编排没问题,不必重走一遍最小调用。
什么情况下这套划分不适用
反过来想一遍更省事:先问「这活值得分层吗」。手头就一个本地脚本,读几个文件、调一两次接口、把结果写回磁盘,这种规模硬塞一层编排进来,光是把参数从这头搬到那头就要写一堆胶水代码。跑一次看一眼结果就完事,改起来还慢半拍。
不是反对分层,是反对给一次性的活儿办长期手续。判断标准很土:这个流程未来一个月还会跑第二次吗,会有别人接手改吗,中间出错需不需要回放定位。三个都答「不」,直接调接口,别搭架子。
| 场景 | 常见误判 | 更合适的做法 |
|---|---|---|
| 单机脚本 / 一次性数据清洗 | 觉得「顺便上个编排以后好扩展」 | 先写最直白的调用,跑通再说 |
| 强监管、链路要全自持 | 默认公共协议实现一定能用 | 先核对合规口径,必要时自己实现通信层 |
| 上游工具本身还在频繁变更 | 先套编排把变化挡在外面 | 先修工具、稳接口,编排往后放 |
| 多人协作、需要回放和审计 | 只按代码量判断要不要分层 | 按定位成本算,能回放就值得分层 |
- 先跑最小闭环不引入任何中间层,直接调接口拿到一次结果,记下从输入到产出用了几个文件、几步手工操作。
- 数一数改动频率回看最近一段时间这个流程改过几次、每次改在哪儿。改在调用参数上,说明问题在工具;改在流程衔接上,才轮到编排。
- 查合规口径强监管场景下,数据能不能出本地、链路能不能经过第三方,这些先问清楚。答案是否,公共协议实现可能直接出局,得自己写通信那段。
- 评估稳定性再决定上游接口是否频繁改字段、报错是否规律,这一项不稳,编排只会把抖动放大,先回头修工具。
还有一种情况不在上面这张表里:团队里没人真正维护那层编排。装上了,跑得还行,但出问题时没人愿意钻进去看,那就等于给自己埋了个黑盒。这种时候少一层反而清爽,等真有人认领维护了再补。具体到各家实现怎么写、怎么选,去 对照着看,别照抄别人的架构。
常见问题
MCP 和 LangChain 是二选一吗?
不是。MCP 管工具怎么被描述和调用,LangChain 管调用顺序和上下文怎么组织。实际项目里常见的是两者同时出现,只是要分清哪部分逻辑写在哪一层,别让同一件事在两边各有一份实现。
我只想接几个现成工具,需要 LangChain 吗?
如果流程是固定的、没有多轮判断和分支,直接把工具调用写进代码就够了,框架带来的抽象反而会让报错位置变模糊。等出现分支变多、状态要跨轮保存时再考虑引入。
自己写个 MCP 服务值不值?
看工具有没有第二方要用。只服务一个应用、只在一个人的机器上跑,写成普通函数更省事;一旦有多个客户端或多个团队要接同一批能力,协议层带来的复用才开始划算。
换模型时哪一边要改?
通常动的是编排层里的模型接入配置,工具那一侧基本不用碰。如果换完模型工具就调不动了,多半是工具描述写得太依赖某个模型的措辞习惯,而不是协议本身的问题。
怎么判断问题出在哪一层?
先单独触发一次工具调用,看参数和返回对不对。这一步过了,问题就在编排层;没过,就在工具定义或传输连接上。顺序反过来查,容易在两处同时改,最后说不清是哪一步生效的。