使用说明

项目简介

LangChain MCP Adapters 是一个用于连接和使用 Model Context Protocol (MCP) 服务器的 LangChain 库。它主要提供工具将 MCP 服务器提供的工具转换为 LangChain 工具,以便在 LangChain 和 LangGraph 框架中无缝使用。此外,该库也包含基于 'fastmcp' 框架构建的简易 MCP 服务器示例,例如 'math_server.py' 和 'weather_server.py',帮助开发者理解和测试 MCP 服务器的搭建与客户端的连接。

主要功能点

  • MCP 工具适配 LangChain: 将 MCP 服务器提供的工具转换为 LangChain 工具,方便在 LangChain 生态系统中使用。
  • 多 MCP 服务器连接: 客户端可以连接到多个 MCP 服务器,并统一管理和调用来自不同服务器的工具。
  • 提供 MCP 服务器示例: 包含基于 'fastmcp' 的简易 MCP 服务器示例,例如数学计算和天气查询服务,用于演示 MCP 服务器的基本功能。

安装步骤

pip install langchain-mcp-adapters

服务器配置

MCP 客户端需要配置连接 MCP 服务器的信息。以下是使用仓库中提供的 'math_server.py' 示例服务器的配置信息(JSON 格式):

{
  "server_name": "math",
  "command": "python",
  "args": ["/path/to/math_server.py"]
}

参数注释:

  • 'server_name': 为该服务器连接自定义的名称,例如 "math"。
  • 'command': 启动 MCP 服务器的命令,通常为 'python'。
  • 'args': 传递给启动命令的参数列表,例如 '["/path/to/math_server.py"]',请务必将 '/path/to/math_server.py' 替换为 'math_server.py' 文件在您本地文件系统中的绝对路径

对于 'weather_server.py' 示例,如果使用 SSE 传输并且服务器运行在 'http://localhost:8000/sse',则配置信息(JSON 格式)如下:

{
  "server_name": "weather",
  "url": "http://localhost:8000/sse",
  "transport": "sse"
}

参数注释:

  • 'server_name': 为该服务器连接自定义的名称,例如 "weather"。
  • 'url': SSE 服务器的 URL 地址,例如 '"http://localhost:8000/sse"'。
  • 'transport': 指定传输协议为 '"sse"' (Server-Sent Events)。

基本使用方法

  1. 启动 MCP 服务器: 首先需要启动 MCP 服务器。可以使用仓库中提供的示例服务器代码 ('math_server.py', 'weather_server.py'),根据 'README.md' 中的指引运行这些脚本。
  2. 配置客户端连接: 在 LangChain 客户端代码中,使用 'MultiServerMCPClient' 类,并根据上述“服务器配置”部分的信息,配置要连接的 MCP 服务器。
  3. 加载和使用工具: 通过 'MultiServerMCPClient' 实例的 'get_tools()' 方法获取所有已连接服务器提供的工具列表。然后可以将这些工具集成到 LangChain Agent 或其他 LangChain 组件中使用,以便在 LLM 应用中调用 MCP 服务器提供的功能。

更详细的使用方法和代码示例,请参考仓库 'README.md' 文件中的 Quickstart 和 Multiple MCP Servers 部分。

信息

分类

开发者工具