@langchain/mcp-adapters

LangChain.js / LangGraph.js 的 MCP 工具适配器,一行代码将任何 MCP Server 接

AI Agent 免费

@langchain/mcp-adapters 是 LangChain 官方发布的 Model Context Protocol(MCP)工具适配器,让 MCP Server 能够直接为 LangChain.js 和 LangGraph.js Agent 提供工具调用能力,GitHub 星标 18121+。

该库的核心价值在于:任何实现了 MCP 协议的 Server(比如文件系统 Server、Math Server 等),无需修改任何代码,即可被 LangChain Agent 驱动使用。

核心功能

1. 多种传输方式

  • STDIO 传输:连接本地 MCP Server,通过标准输入输出通信
  • Streamable HTTP 传输:连接远程 MCP Server,支持自定义 Header(用于认证),自动降级为 SSE 以兼容旧版 MCP Server 实现
  • OAuth 2.0 认证:支持安全的 OAuth 认证流程,适合需要保护的企业级 MCP Server

2. 多服务器管理

  • 同时连接多个 MCP Server
  • 工具可按服务器名称前缀组织,也可展平为统一集合
  • 每个 Server 独立配置重连策略(重试次数、间隔)

3. Agent 集成

  • 兼容 LangChain.js 和 LangGraph.js
  • 针对 OpenAI、Anthropic 和 Google 模型优化
  • 支持富内容响应(文本、图片、嵌入资源)
  • 使用标准 Content Block 格式输出工具结果

4. 开发体验

  • 使用 debug 包输出详细日志
  • 灵活的配置选项和健壮的错误处理
  • 工具加载失败可选择抛出异常或忽略

安装方式

npm install @langchain/mcp-adapters

入门示例

import { createAgent } from "langchain";
import { ChatOpenAI } from "@langchain/openai";
import { MultiServerMCPClient } from "@langchain/mcp-adapters";

const client = new MultiServerMCPClient({
  mcpServers: {
    math: {
      transport: "stdio",
      command: "npx",
      args: ["-y", "@modelcontextprotocol/server-math"],
    },
    filesystem: {
      transport: "stdio",
      command: "npx",
      args: ["-y", "@modelcontextprotocol/server-filesystem"],
    },
  },
});

const tools = await client.getTools();
const model = new ChatOpenAI({ model: "gpt-4o-mini", temperature: 0 });
const agent = createAgent({ llm: model, tools });

const response = await agent.invoke({
  messages: [{ role: "user", content: "what is (3 + 5) x 12?" }],
});
console.log(response);

await client.close();

适用场景:在 LangChain 工作流中接入任何 MCP 生态工具(比如官方 MCP Server 生态中的 100+ 工具)、构建企业级多工具 Agent、跨语言/跨服务调用 MCP 工具。是 LangChain 生态与 MCP 生态之间的桥梁。

团队信息

由 AI 猎手自动发现

评论与建议

0 条评论