将 Langflow 作为 MCP 客户端使用
Langflow 与 模型上下文协议 (MCP) 集成,既可作为 MCP 服务器,也可作为 MCP 客户端。
本页面介绍如何通过 MCP Tools 组件 和已连接的 MCP 服务器,将 Langflow 用作 MCP 客户端。
有关将 Langflow 用作 MCP 服务器的信息,请参阅 将 Langflow 用作 MCP 服务器。
使用 MCP tools 组件
MCP Tools 组件连接到 MCP 服务器,以便 Langflow 智能体 在响应用户查询时可以使用该服务器的工具。
此组件有两种模式,具体取决于您要访问的服务器类型:
- 通过 JSON 配置文件、服务器启动命令或 HTTP/SSE URL 连接到非 Langflow MCP 服务器,以访问外部非 Langflow MCP 服务器提供的工具。
- 连接到 Langflow MCP 服务器,将来自您的 Langflow 项目 的流作为 MCP 工具使用。
连接到非 Langflow MCP 服务器
-
在您的流中添加一个 MCP Tools 组件。
-
在 MCP Server 字段中,选择之前连接过的服务器或点击 Add MCP Server (添加 MCP 服务器).
有多种方式可以添加新服务器:
- JSON:将 MCP 服务器的 JSON 配置对象粘贴到字段中(包括您要使用的必选和可选参数),然后点击 Add Server。
- STDIO:输入 MCP 服务器的 Name (名称)、Command (命令) 以及服务器使用的任何 Arguments (参数) 和 Environment Variables (环境变量),然后点击 Add Server。例如,要启动 Fetch 服务器,Command 为
uvx mcp-server-fetch。 - HTTP/SSE:输入 MCP 服务器的 Name (名称)、URL 以及服务器使用的任何 Headers (请求头) 和 Environment Variables (环境变量),然后点击 Add Server。Langflow MCP 服务器的默认 URL 为
https://:7860/api/v1/mcp/project/PROJECT_ID/streamable或https://:7860/api/v1/mcp/streamable。更多信息请参阅 连接到 Langflow MCP 服务器。
提示Langflow 软件包中随
uv包含了uvx。要使用
npx服务器命令,您必须先安装 Node.js 的 LTS 版本。如果您在 Docker 中运行 Langflow,请在容器镜像中安装 Node.js 并重新构建,以便在运行时可以使用基于npx的 MCP 服务器。更多信息请参阅 包管理。有关在 Langflow 中使用
npxMCP 服务器的示例,请参阅 将 Astra DB MCP 服务器连接到 Langflow。 -
要在服务器命令中使用环境变量,请在 Env 字段中以键值对的形式输入每个变量。
提示Langflow 会将
.env文件中的环境变量传递给 MCP,但不会传递您在 Langflow Settings (设置) 中声明的全局变量。要将 MCP 服务器环境变量定义为全局变量,请在启动时将其添加到 Langflow 的.env文件中。更多信息请参阅 全局变量。 -
在 Tool 字段中,选择您希望此组件使用的特定工具,或将该字段留空以允许访问该 MCP 服务器提供的所有工具。
如果您选择了特定工具,可能需要配置额外的工具特定字段。有关工具特定字段的信息,请参阅您的 MCP 服务器文档。
此时,MCP Tools 组件正在提供来自已连接服务器的工具,但还没有任何组件在使用该工具。接下来的步骤将说明如何使该工具对 Agent 组件 可用,以便智能体可以在其响应中使用该工具。
-
在 组件的标题菜单 中,启用 Tool mode (工具模式),以便您可以将该组件与智能体一起使用。
-
将 MCP Tools 组件的 Toolset 端口连接到 Agent 组件的 Tools 端口。
如果您的流中尚未包含这些组件,请确保同时将 Chat Input 和 Chat Output 组件连接到 Agent 组件。

-
测试您的流以确保 MCP 服务器已连接且选定的工具正被智能体使用。打开 Playground,然后输入一个需要用到通过 MCP Tools 组件连接的工具的提示词。
例如,如果您配合
fetch工具使用mcp-server-fetch,您可以要求智能体总结最近的科技新闻。智能体将调用 MCP 服务器函数fetch,然后返回响应。 -
如果您希望智能体能够使用更多工具,请重复这些步骤,添加更多连接了不同服务器或工具的工具组件。
连接到 Langflow MCP 服务器
每个 Langflow 项目都会运行一个独立的 MCP 服务器,将项目的流公开为 MCP 工具。有关项目 MCP 服务器(包括将流公开为 MCP 工具)的更多信息,请参阅 将 Langflow 用作 MCP 服务器。
Langflow MCP 服务器同时支持 streamable HTTP 传输和 服务器发送事件 (SSE) 作为备选方案。
要利用“流即工具 (flows-as-tools)”,请使用 MCP Tools 组件连接到项目的 MCP 端点:
-
在流中添加一个 MCP Tools 组件,点击 Add MCP Server,然后选择 HTTP/SSE 模式。
-
在 MCP URL 字段中,输入您的 Langflow 服务器的 MCP 端点。
- 特定于项目的服务器:
https://:7860/api/v1/mcp/project/PROJECT_ID/streamable - 全局 MCP 服务器:
https://:7860/api/v1/mcp/streamable - Langflow Desktop 默认值:
https://:7868/
目标服务器上所有可用的流都将被视为工具。
- 特定于项目的服务器:
-
在 组件的标题菜单 中,启用 Tool Mode (工具模式),以便您可以将该组件与智能体一起使用。
-
将 MCP Tools 组件的 Toolset 端口连接到 Agent 组件的 Tools 端口。
-
如果您的流中尚未包含这些组件,请确保同时将 Chat Input 和 Chat Output 组件连接到 Agent 组件。

-
测试您的流以确保智能体使用您的流来响应查询。打开 Playground,然后输入一个会用到通过 MCP Tools 组件连接的流的提示词。
-
如果您希望智能体能够使用更多工具,请重复这些步骤,添加更多连接了不同服务器或工具的工具组件。
MCP Tools 参数
| 名称 | 类型 | 描述 |
|---|---|---|
| mcp_server | 字符串 | 输入参数。要连接的 MCP 服务器。从之前配置的服务器中选择或添加新服务器。 |
| tool | 字符串 | 输入参数。要从连接的 MCP 服务器执行的具体工具。留空则允许访问所有工具。 |
| use_cache | 布尔型 | 输入参数。启用 MCP 服务器和工具的缓存以提高性能。默认值:false。 |
| verify_ssl | 布尔型 | 输入参数。为 HTTPS 连接启用 SSL 证书验证。默认值:true。 |
| response | 数据帧 (DataFrame) | 输出参数。包含已执行工具响应的 DataFrame。 |
管理已连接的 MCP 服务器
要为您的 Langflow 客户端管理所有 MCP 服务器连接,请点击 可视化编辑器中的 MCP servers,或者点击您的头像,选择 Settings,然后点击 MCP Servers。
要添加新的 MCP 服务器,点击 Add MCP Server,然后按照 使用 MCP Tools 组件 中的步骤配置连接并在流中使用该服务器。
点击 点击 More (更多) 来编辑或删除 MCP 服务器连接。