← 返回目录

n8n MCP Client Node

社区

在 n8n 工作流中连接并调用 MCP 服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 355 / 438
Stars: ★ 3.0k 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 9 个月前 ⚠
工具数: 6

40FMRS · D

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

最强项 · 安装易用性 11/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

6/20

维护活跃度

7/20

文档质量

11/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 提供的证据仅有 README，没有包清单、源码、测试或 CI。该仓库是 n8n 的 MCP 客户端节点，而非独立 MCP 服务器，因此评审语料中无法观察到 MCP 初始化与工具列表握手。README 声称支持 STDIO、SSE 和 HTTP Streamable 三种传输及六种操作，使正常路径看似合理，但启动、错误处理和依赖可控性均未得到验证。因缺少清单、测试和执行证据而扣分，按照静态评审规则给低分。
安全与权限 6/20: README 中未发现恶意代码或令牌泄露；凭据被描述为由 n8n 存储，并可通过环境变量或请求头传递。但源码未能验证加密、最小权限范围、输出清洗，或对可能产生副作用的远程工具执行是否要求确认。该节点会主动向外部 MCP 服务器发送数据，数据边界不清晰。因权限/确认机制无法验证而扣分；未触发红线。
维护活跃度 7/20: 许可证为 MIT，仓库未归档，且有公开的 issue 跟踪器，这些是积极的维护信号。但提供的材料中没有发布历史、提交频率、依赖更新健康度、贡献者治理或安全响应渠道。未提供明确的安全策略文件。得分反映了可见的许可证和活跃状态，但缺少治理与更新证据。
文档质量 11/20: README 确实很有帮助：安装链接、三种传输的凭据格式、环境变量用法、操作列表、AI Agent 工具配置、Docker 示例和兼容性说明。扣分点：没有故障排查章节，未披露限制/成本，工具参数是动态的且仅作通用描述，兼容性部分未提及 HTTP Streamable，而 README 开头却将 SSE 标记为弃用。另有外部徽章（如 MseeP）等声明在提供的语料中无法验证。
安装易用性 11/20: 针对单一平台（n8n）的设置说明较清楚：作为 n8n 社区节点安装、创建三种凭据之一并配置操作；Docker 环境变量和必需的 N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE 均有文档。但该方案依赖 n8n 运行时，需要手动配置环境，且源码中没有可验证的一键命令或客户端示例。由于没有提交的测试/CI 可证明安装路径，静态校准不允许超过 15 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

希望将 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 下载的软件包）可能引入不安全的依赖。

安装接入

准备工作

运行环境：Node.js · Docker

MCP_BRAVE_API_KEY 可选密钥 Docker 部署时以 MCP_ 前缀传递给 MCP 服务器的 Brave API 密钥，从 Brave 官方获取。

BRAVE_API_KEY 可选密钥通过凭证 UI 传给 Brave Search MCP 服务器的 API 密钥，从 Brave 官方获取。

其他可选配置项（1 个）

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE 可选设为 true 才能在 n8n AI Agent 中把该社区节点作为工具使用，在 shell、Docker 或 .env 中设置。

在 n8n 中安装社区节点：

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

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

验证是否装好

在 n8n 中添加 MCP Client 节点并选择 List Tools 操作，若能返回服务器工具列表（如 brave_search）则说明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出这个 MCP 服务器上所有可用的工具
用 brave_search 工具搜索最新的 AI 新闻
读取 URI 指定的资源内容
获取服务器上可用的提示模板列表

工具能力 6

execute_tool 写入

使用给定参数执行指定工具。

get_prompt 只读

获取特定的提示模板。

list_prompts 只读

列出所有可用的提示。

list_resources 只读

列出服务器提供的所有资源。

list_tools 只读

列出所有可用工具及其描述和参数模式。

read_resource 只读

按 URI 读取特定资源。

使用场景

在 n8n 工作流中连接外部 MCP 服务器，例如 Brave Search、OpenAI、Serper、Weather 等。

让 AI 代理通过 MCP 调用多种工具，例如在旅途中搜索热门目的地、查询城市天气和获取旅行限制新闻。

在 n8n 中管理 MCP 资源、提示和工具。

支持客户端

Claude Desktop部分支持

依据项目文档列出，未经本站实测。

详细介绍

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