如何高效使用n8n-nodes-mcp：从安装到实战的完整指南

如何高效使用n8n-nodes-mcp：从安装到实战的完整指南

【免费下载链接】n8n-nodes-mcpn8n custom node for MCP项目地址: https://gitcode.com/gh_mirrors/n8/n8n-nodes-mcp

n8n-nodes-mcp是一款强大的n8n社区节点，它让你能够在工作流中与Model Context Protocol (MCP)服务器交互，连接AI模型与外部工具和数据源。本文将带你了解其工具执行原理，并通过实际案例掌握从安装配置到 workflow 设计的全过程。

快速了解n8n-nodes-mcp

n8n-nodes-mcp作为n8n的社区节点，实现了与MCP服务器的标准化对接。MCP（Model Context Protocol）是一种让AI模型能够以统一方式与外部工具和数据源交互的协议，通过这个节点，你可以轻松连接MCP服务器、访问资源、执行工具和使用提示词。

图：n8n-nodes-mcp在工作流中的应用示例，展示了AI Agent与MCP Client节点的协作关系

简单三步安装配置

1. 基础安装

按照n8n社区节点文档的安装指南进行基础安装。如果你计划将MCP Client节点用作AI Agents的工具，必须设置环境变量：

export N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

2. 选择连接方式

n8n-nodes-mcp支持三种连接MCP服务器的方式：

• 命令行传输(STDIO)：通过命令行启动MCP服务器
• HTTP Streamable传输(推荐)：现代高效的流式传输方式
• 服务器发送事件(SSE)：传统方式，已 deprecated但仍支持

3. 配置凭证

以最常用的命令行传输方式为例，你需要配置：

图：MCP Client节点的凭证配置界面，展示了命令和参数设置区域

• Command：启动MCP服务器的命令
• Arguments：传递给服务器的可选参数
• Environment Variables：以NAME=VALUE格式设置的环境变量

核心操作详解

n8n-nodes-mcp提供了多种实用操作，帮助你充分利用MCP服务器的功能：

图：MCP Client节点支持的操作列表，包括执行工具、获取提示词等功能

列出可用工具（List Tools）

这个操作会从MCP服务器获取所有可用工具，包括它们的名称、描述和参数模式。

图：List Tools操作的结果展示，包含工具名称、描述和参数结构

执行工具（Execute Tool）

选择特定工具并传递参数执行，是最常用的核心功能。例如执行Brave搜索工具：

1. 添加MCP Client节点
2. 选择"Execute Tool"操作
3. 从下拉菜单选择"brave_search"工具
4. 设置参数：{"query": "latest AI news"}

执行后，节点会返回搜索结果供后续流程使用。

图：Execute Tool操作的结果界面，显示工具返回的详细信息

实战案例：多服务器AI Agent工作流

以下是一个生产环境中的多MCP服务器配置示例，让AI Agent能够使用多种工具：

1. Docker配置

version: '3' services: n8n: image: n8nio/n8n environment: # MCP服务器环境变量 - MCP_BRAVE_API_KEY=your-brave-api-key - MCP_OPENAI_API_KEY=your-openai-key - MCP_SERPER_API_KEY=your-serper-key - MCP_WEATHER_API_KEY=your-weather-api-key # 允许社区节点作为工具 - N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true ports: - "5678:5678" volumes: - ~/.n8n:/home/node/.n8n

2. 创建多种MCP凭证

为不同功能的MCP服务器创建独立凭证，如Brave搜索、OpenAI工具、Web搜索和天气API等。

3. 设计AI Agent工作流

创建一个AI Agent节点，启用MCP Client作为工具，并配置不同MCP Client节点使用不同凭证。

示例AI Agent提示词：

我需要你帮我规划旅行。首先，搜索{destination_country}的热门目的地。 然后，查看前三名城市的当前天气。 最后，查找这些地方最近的旅行限制新闻。

通过这种配置，AI代理可以跨多个MCP服务器使用多种工具，全部通过Docker部署中配置的环境变量进行管理。

兼容性与资源

• 版本要求：需要n8n 1.0.0或更高版本，兼容MCP协议1.0.0或更高版本
• 官方文档：Model Context Protocol Documentation
• TypeScript SDK：MCP TypeScript SDK

通过本文的指南，你应该已经掌握了n8n-nodes-mcp的核心功能和使用方法。这个强大的节点为你的n8n工作流打开了与各种AI工具和服务交互的大门，无论是简单的搜索操作还是复杂的多工具AI代理，都能轻松实现。

开始使用n8n-nodes-mcp，体验AI工作流自动化的无限可能吧！需要获取项目源码，可以通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/n8/n8n-nodes-mcp

【免费下载链接】n8n-nodes-mcpn8n custom node for MCP项目地址: https://gitcode.com/gh_mirrors/n8/n8n-nodes-mcp