← 返回目录
N

n8n MCP Client Node

社区
在 n8n 工作流中连接并调用 MCP 服务器。
GitHub 源仓库 ↗
★ 3.0k Stars 分类 · 开发工具 热门 源版本 6ee215b30e51
40FMRS · D
可靠性
5/20
安全与权限
6/20
维护活跃度
7/20
文档质量
11/20
安装易用性
11/20

该节点能够将 MCP 服务器无缝集成到 n8n 工作流中,支持多种传输方式,并可作为 AI 代理的工具。然而,它需要适当的安全配置,尤其是当使用本地命令时。

查看 FMRS 评分方法 →

n8n-nodes-mcp-client 是 n8n 的社区节点,允许你在 n8n 工作流中连接 Model Context Protocol (MCP) 服务器。它支持访问资源、执行工具和使用提示,可在 AI 代理中作为工具使用,支持 STDIO、SSE(已弃用)和 HTTP Streamable 传输方式。

工具能力

execute_tool
使用给定参数执行指定工具。
get_prompt
获取特定的提示模板。
list_prompts
列出所有可用的提示。
list_resources
列出服务器提供的所有资源。
list_tools
列出所有可用工具及其描述和参数模式。
read_resource
按 URI 读取特定资源。

安装接入

在 n8n 中安装社区节点:

  1. 前往 n8n 的“设置”->“社区节点”。
  2. 输入包名 n8n-nodes-mcp-client 并安装。
  3. 也可参考 n8n 官方文档安装社区节点。

若要在 AI 代理中使用此节点作为工具,必须设置环境变量 N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true,并重启 n8n。

选型与风险

适合谁

  • 希望将 MCP 工具集成到自动化流程中的 n8n 用户。
  • 构建能调用外部数据源和服务的 AI 代理的开发者。
  • 需要快速连接各种 MCP 服务器(通过 npx 或远程 HTTP)的团队。

不适合谁

  • 不适用于需要直接编程接口、而非图形化工作流的开发者。
  • 不适用于没有 n8n 环境、只想使用独立 MCP 客户端的场景。
  • 不适用于对 SSE 有严格依赖且无法升级到 HTTP Streamable 的用户(SSE 已弃用)。

所需权限

  • 需要配置 n8n 社区节点功能(安装节点)。
  • 需要设置环境变量 N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true 以允许节点作为工具使用。
  • 通过 STDIO 传输时,可执行任意本地命令(由用户提供的 command 决定),这些命令可能具有系统权限。
  • 可向配置的 MCP 服务器发出网络请求,包括发送额外的请求头。

风险与副作用

  • STDIO 命令可执行任意本地命令,若配置不当(如使用不受信任的服务器),可能导致系统被攻破。
  • SSE 传输已弃用且无更新,可能存在安全漏洞。
  • 环境变量(如 API 密钥)可能通过凭证界面存储在 n8n 中,若 n8n 实例不安全,则存在泄露风险。
  • 运行第三方 MCP 服务器(如通过 npx 下载的软件包)可能引入不安全的依赖。

常见排障

  1. 确保 n8n 版本至少为 1.0.0。
  2. 如果你需要在 AI 代理中使用工具,确认已设置 N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true 并重启 n8n。
  3. 检查命令和参数是否正确,特别是本地 npx 服务器。
  4. 确认 MCP 服务器 URL 可达,且额外请求头已正确设置。
  5. SSE 连接失败时,考虑改用 HTTP Streamable(推荐)。

使用场景

在 n8n 工作流中连接外部 MCP 服务器,例如 Brave Search、OpenAI、Serper、Weather 等。
让 AI 代理通过 MCP 调用多种工具,例如在旅途中搜索热门目的地、查询城市天气和获取旅行限制新闻。
在 n8n 中管理 MCP 资源、提示和工具。

支持客户端

Claude Desktop部分支持