mcpField
M
MCP Tools Usage From LangChain / Example in TypeScript

MCP Tools Usage From LangChain / Example in TypeScript

github.com/hideya框架与 SDK1231 周前更新

关于 MCP Tools Usage From LangChain / Example in TypeScript

这是一个将 MCP 服务工具接入 LangChain ReAct Agent 的 TypeScript 示例。它使用 `convertMcpToLangchainTools()` 并行初始化多个服务,并将其工具转换为 LangChain 可用的格式。

主要功能

  1. 01并行初始化多个 MCP 服务
  2. 02转换为 LangChain StructuredTools
  3. 03按提供商转换工具架构
  4. 04包含 OpenAI 模型示例及其他选项

适用场景

  1. 01在 LangChain ReAct Agent 中使用 MCP 服务工具
  2. 02从多个 MCP 服务初始化工具
  3. 03为支持的 LLM 提供商调整工具架构

MCP 相关

该示例作为 MCP 客户端,初始化指定的 MCP 服务,并将其工具提供给 LangChain ReAct Agent。

详细介绍

来自 LangChain 的 MCP 工具用法 / TypeScript 示例 许可证:MIT

这个简单的 Model Context Protocol(MCP) 客户端演示了 LangChain ReAct Agent 如何使用 MCP 服务工具。

它使用了 @h1deya/langchain-mcp-tools 中的实用函数 convertMcpToLangchainTools()。
此函数会并行初始化指定的多个 MCP 服务,并将其可用工具转换为 LangChain 兼容工具数组 (StructuredTool[])。 它还会执行特定于 LLM 提供商的架构转换, 以避免架构兼容性问题。

此处使用 OpenAI 的 gpt-5.4-mini 作为 LLM。 为方便起见,也附带了 OpenAI 和 Anthropic LLM 的代码,并已注释。

此处提供了一个更贴近实际(对话式)的 MCP 客户端。

此处提供了此应用的 Python 等效版本。

先决条件

  • Node.js 18+
  • npm 8+(npx),用于运行基于 Node.js 的 MCP 服务
  • [可选] npm 7+(npx), 用于运行基于 Node.js 包的本地 MCP 服务
  • [可选] 安装 uv(uvx), 用于运行基于 Python 的 MCP 服务
  • 按需提供来自以下平台的 LLM API 密钥: OpenAI、 Anthropic、 Google GenAI 和/或 xAI

用法

  1. 安装依赖:

    npm install
    
  2. 设置 API 密钥:

    cp .env.template .env
    
    • 按需更新 .env。
    • .gitignore 已配置为忽略 .env, 以防止意外提交凭据。
  3. 运行应用:

    npm start
    

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。