将 Langflow 用作 MCP 客户端

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

本页介绍了如何通过 MCP Tools (MCP 工具) 组件 和连接的 MCP 服务器 将 Langflow 用作 MCP 客户端。

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

使用 MCP 工具组件

MCP Tools 组件连接到 MCP 服务器，以便 Langflow 代理 (Agent) 在响应用户查询时可以使用该服务器的工具。

根据您要访问的服务器类型，该组件有两种模式：

• 连接到非 Langflow MCP 服务器：使用 JSON 配置文件、服务器启动命令或 HTTP/SSE URL 来访问由外部非 Langflow MCP 服务器提供的工具。
• 连接到 Langflow MCP 服务器：将您的 Langflow 项目 中的流作为 MCP 工具使用。

连接到非 Langflow MCP 服务器

1. 向您的流中添加一个 MCP Tools 组件。

2. 在 MCP Server (MCP 服务器) 字段中，选择之前连接的服务器，或点击 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 为 http://localhost:7860/api/v1/mcp/project/PROJECT_ID/streamable 或 http://localhost:7860/api/v1/mcp/streamable。有关更多信息，请参阅 连接到 Langflow MCP 服务器。
   提示

   uvx is included with uv in the Langflow package.

   To use npx server commands, you must first install an LTS release of Node.js. If you run Langflow in Docker, install Node.js inside the container image and rebuild so that npx-based MCP servers are available at runtime. For more information, see Package management.

   For an example of an npx MCP server in Langflow, see Connect an Astra DB MCP server to Langflow.

3. 要在服务器命令中使用环境变量，请在 Env 字段中以键值对的形式输入每个变量。

   提示

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

4. 在 Tool (工具) 字段中，选择您希望此组件使用的特定工具，或留空以允许访问 MCP 服务器提供的所有工具。

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

   至此，MCP Tools 组件正在提供来自连接服务器的工具，但还没有任何东西在使用该工具。接下来的步骤将解释如何使该工具对 Agent (代理) 组件 可用，以便代理可以在其响应中使用该工具。

5. 在组件标题菜单中启用 Tool mode (工具模式)，以便您可以将该组件与代理一起使用。

6. 将 MCP Tools 组件的 Toolset (工具集) 端口连接到 Agent (代理) 组件的 Tools (工具) 端口。

   如果流中尚未包含 Chat Input (聊天输入) 和 Chat Output (聊天输出) 组件，请确保将它们也连接到 Agent 组件。

   

7. 测试您的流，确保 MCP 服务器已连接且代理使用了所选工具。打开 游乐场 (Playground)，然后输入一个使用您通过 MCP Tools 组件连接的工具的提示词。

   例如，如果您将 mcp-server-fetch 与 fetch 工具一起使用，您可以要求代理总结最近的科技新闻。代理将调用 MCP 服务器函数 fetch，然后返回响应。

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

连接 Langflow MCP 服务器

每个 Langflow 项目都会运行一个独立的 MCP 服务器，将项目的流公开为 MCP 工具。 有关您的项目 MCP 服务器的更多信息（包括将流公开为 MCP 工具），请参阅 将 Langflow 用作 MCP 服务器。

Langflow MCP 服务器同时支持 streamable HTTP 传输和 Server-Sent Events (SSE) 作为回退方案。

要利用流作为工具，请使用 MCP Tools 组件连接到项目的 MCP 端点：

1. 向您的流中添加一个 MCP Tools 组件，点击 Add MCP Server (添加 MCP 服务器)，然后选择 HTTP/SSE 模式。

2. 在 MCP URL 字段中，输入您的 Langflow 服务器的 MCP 端点。

   • 项目特定服务器：http://localhost:7860/api/v1/mcp/project/PROJECT_ID/streamable
   • 全局 MCP 服务器：http://localhost:7860/api/v1/mcp/streamable
   • Langflow 桌面版默认地址：http://localhost:7868/

   来自目标服务器的所有可用流都将被视为工具。

3. 在组件标题菜单中启用 Tool Mode (工具模式)，以便您可以将该组件与代理一起使用。

4. 将 MCP Tools 组件的 Toolset (工具集) 端口连接到 Agent (代理) 组件的 Tools (工具) 端口。

5. 如果流中尚未包含 Chat Input (聊天输入) 和 Chat Output (聊天输出) 组件，请确保将它们也连接到 Agent 组件。

   

6. 测试您的流，确保代理使用您的流来响应查询。打开 游乐场 (Playground)，然后输入一个使用您通过 MCP Tools 组件连接的流的提示词。

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

MCP 工具参数

名称	类型	描述
mcp_server	字符串	输入参数。要连接的 MCP 服务器。从之前配置的服务器中选择或添加新服务器。
tool	字符串	输入参数。要从连接的 MCP 服务器执行的特定工具。留空则允许访问所有工具。
use_cache	布尔值	输入参数。启用 MCP 服务器和工具的缓存以提高性能。默认值：false。
verify_ssl	布尔值	输入参数。为 HTTPS 连接启用 SSL 证书验证。默认值：true。
response	DataFrame	输出参数。包含所执行工具响应的 DataFrame。

管理连接的 MCP 服务器

要管理您的 Langflow 客户端的所有 MCP 服务器连接，请在可视化编辑器中点击 MCP 服务器 (MCP servers)，或点击您的个人资料图标，选择 Settings (设置)，然后点击 MCP Servers。

要添加新的 MCP 服务器，请点击 Add MCP Server (添加 MCP 服务器)，然后按照 使用 MCP 工具组件 中的步骤配置连接并在流中使用该服务器。

点击 更多 (More) 来编辑或删除 MCP 服务器连接。

另请参阅

• 将 Langflow 用作 MCP 服务器
• 将 DataStax Astra DB MCP 服务器与 MCP 工具组件结合使用