跳到主要内容

将 Langflow 用作 MCP 客户端

Langflow 集成了 模型上下文协议 (MCP),既可以作为 MCP 服务器,也可以作为 MCP 客户端。

本页面描述如何使用 MCP 工具 组件和设置中的 MCP 服务器 页面将 Langflow 用作 MCP 客户端。

有关将 Langflow 用作 MCP 服务器的信息,请参阅 将 Langflow 用作 MCP 服务器

使用 MCP 工具组件

MCP 工具 组件连接到 模型上下文协议 (MCP) 服务器,并将 MCP 服务器的工具暴露为 Langflow 代理 的工具。

该组件有两种模式,取决于您要访问的服务器类型:

连接到非 Langflow MCP 服务器

  1. 向您的流程添加一个 MCP 工具 组件。

  2. MCP 服务器 字段中,选择您要添加的服务器,或单击 添加 MCP 服务器

    有多种方式添加新服务器。

    • JSON 面板中,粘贴 MCP 服务器的 JSON 配置文件,然后单击 添加服务器
    • STDIO 面板中,输入 MCP 服务器的 名称命令 以及服务器使用的任何 参数环境变量,然后单击 添加服务器。 例如,要启动 Fetch 服务器,命令uvx mcp-server-fetch
    • SSE 面板中,输入您的 Langflow MCP 服务器的 名称SSE URL 以及服务器使用的任何 标头环境变量,然后单击 添加服务器。 默认的 SSE URLhttp://localhost:7860/api/v1/mcp/sse。有关更多信息,请参阅 使用 SSE 模式

    uvx 包含在 Langflow 包的 uv 中。 要使用 npx 服务器命令,您必须先安装 Node.js 的 LTS 版本。 有关在 Langflow 中使用 npx MCP 服务器的示例,请参阅 将 Astra DB MCP 服务器连接到 Langflow

  3. 要在服务器命令中使用环境变量,请在 Env 字段中输入每个变量,就像在脚本中定义它们一样,例如 VARIABLE=value

    important

    Langflow 将 .env 文件中的环境变量传递给 MCP,但不会传递在 Langflow UI 中声明的全局变量。 要将 MCP 服务器环境变量定义为全局变量,请在启动时将其添加到 Langflow 的 .env 文件中。 有关更多信息,请参阅 全局变量

  4. 工具 字段中,选择您希望此组件使用的工具,或将字段留空以允许访问 MCP 服务器提供的所有工具。

    如果您选择特定工具,可能需要配置其他特定于工具的字段。有关特定于工具的字段的信息,请参阅您的 MCP 服务器文档。

    此时,MCP 工具 组件正在提供工具,但没有任何东西在使用该工具。下一步说明如何使工具对 代理 组件 可用,以便代理可以在其响应中使用该工具。

  5. 组件菜单 中,启用 工具模式,以便您可以将组件与代理一起使用。

  6. MCP 工具 组件的 工具集 端口连接到 代理 组件的 工具 端口。

    如果您的流程中尚未存在,请确保还将 聊天输入聊天输出 组件附加到 代理 组件。

    stdio 模式下的 MCP 工具组件

  7. 测试您的流程以确保 MCP 服务器已连接且代理使用了所选工具:单击 Playground,然后输入使用通过 MCP 工具 组件连接的工具的提示。 例如,如果您使用 mcp-server-fetchfetch 工具,您可以要求代理总结最新的科技新闻。代理调用 MCP 服务器函数 fetch,然后返回响应。

  8. 如果您希望代理能够使用更多工具,请重复这些步骤以添加具有不同服务器或工具的更多工具组件。

连接 Langflow MCP 服务器

每个 Langflow 项目都运行一个单独的 MCP 服务器,将项目的流程暴露为 MCP 工具。 有关您项目的 MCP 服务器的更多信息,包括如何管理暴露的流程,请参阅 将 Langflow 用作 MCP 服务器

要利用流程即工具功能,请使用 服务器推送事件 (SSE) 模式下的 MCP 工具 组件连接到项目的 /api/v1/mcp/sse 端点:

  1. 向您的流程添加一个 MCP 工具 组件,单击 添加 MCP 服务器,然后选择 SSE 模式。
  2. MCP SSE URL 字段中,修改默认地址以指向您的 Langflow 服务器的 SSE 端点。其他 Langflow 安装的默认值是 http://localhost:7860/api/v1/mcp/sse。 在 SSE 模式下,目标服务器上可用的所有流程都被视为工具。
  3. 组件菜单 中,启用 工具模式,以便您可以将组件与代理一起使用。
  4. MCP 工具 组件的 工具集 端口连接到 代理 组件的 工具 端口。如果您的流程中尚未存在,请确保还将 聊天输入聊天输出 组件附加到 代理 组件。 启用 SSE 模式的 MCP 组件
  5. 测试您的流程以确保代理使用您的流程响应查询:单击 Playground,然后输入使用通过 MCP 工具 组件连接的流程的提示。
  6. 如果您希望代理能够使用更多流程,请重复这些步骤以添加选择了不同服务器或工具的更多 MCP 工具 组件。

MCP 工具参数

名称类型描述
commandString输入参数。仅限 Stdio 模式。MCP 服务器启动命令。默认值:uvx mcp-sse-shim@latest
sse_urlString输入参数。仅限 SSE 模式。Langflow 项目的 MCP 服务器的 SSE URL。Langflow Desktop 的默认值:http://localhost:7868/。其他安装的默认值:http://localhost:7860/api/v1/mcp/sse
toolsList[Tool]输出参数。包含 MCP 服务器暴露的工具列表的 Tool 对象。

管理已连接的 MCP 服务器

设置 > MCP 服务器 页面管理连接到 Langflow 客户端的 MCP 服务器。

要添加新的 MCP 服务器,请单击 添加 MCP 服务器 打开配置面板,然后按照 使用 MCP 工具组件 中的步骤操作。

单击 更多 以配置或删除 MCP 服务器。

另请参阅

Search