创建

登录 ReadmeX

或

了解我们如何处理你的信息: 隐私政策

ReadmeX

陪你读懂 AI 动态

今天,想先了解什么?

选一份动态总结,或直接聊聊你的问题。

社区和关注动态总结只属于你自己。

资讯

LangGraph 接入 MCP 与工具治理实战

AI 总结

一篇掘金指南介绍了在 Agent 项目中将 Model Context Protocol(MCP)接入 LangGraph 的方法,建议本地开发使用 stdio 连接,并通过 MCP_URL 等环境变量区分本地与线上资源。作者建议采用模块级懒加载、缓存工具列表、领域化图路由、结果截断、优雅降级,以及渐进披露或工具检索,以应对工具增多后的选择错误。文中还提醒读者注意容器内部 DNS、镜像缺少 Node.js、依赖浏览器授权的 OAuth,以及凭证写入镜像等风险。

深度见解

该指南为 MCP 接入 LangGraph 提供了具体的架构与工具治理方案,但这些建议来自单一作者,尚未经过独立验证。

最近在 Agent 项目中接入了 MCP(Model Context Protocol),踩了不少坑。今天就以 LangGraph 为例,聊聊 MCP 接入的架构设计、环境切换以及当 MCP 工具越来越多时,如何防止大模型“注意力涣散”。

一、 本地开发与线上部署怎么选?

在本地开发时,强烈推荐使用 stdio 模式直起,而不是去连 Docker 或线上环境。

  • 优势:改完代码重启即生效,不用 build 镜像;不依赖 docker network 和端口映射;协议层完全一致。
  • 避坑:不要本地直连线上容器地址(如 http://mcp-xxx:8765),这是 Docker 内部 DNS,本地解析不了。
  • 环境隔离:MCP 连的是它所在环境的数据库。本地 stdio 连本地库,线上连线上库。建议用环境变量(如 MCP_URL)区分,并且在线上使用 docker-compose 时,务必用 environment 覆盖 .env,因为 environment 优先级更高。

二、 代码设计与架构建议

  • 依赖与连接:使用 langchain-mcp-adapters,做成模块级懒加载单例。首次用到时建连并缓存 list_tools(),不要每次请求都去握手。
  • 工具过滤:服务端可能给了 12 个工具,但 Agent 端只留 4~5 个核心的。模型选错的概率与工具数量成正比。
  • 图结构设计:不要把所有工具直接绑给 Supervisor(主管节点),这会导致路由逻辑混乱。建议采用 supervisor -> research | data | writer 的结构,把 data 做成一个小型的 ReAct 循环。
  • 结果截断与降级:对于查询类工具,结果最多返回 500 行,截断到 20~30 行并转成 Markdown 表格,防止 token 爆炸。如果 MCP 挂掉,data 节点要优雅降级(返回“服务暂不可用”),绝不能拖垮主流程导致 500。

#LangGraph#Model Context Protocol#langchain-mcp-adapters

原文约 3 分钟读完阅读原文
群聊

还没有评论,来说说你的看法。