← 返回目录

n8n Workflow Builder

社区

通过自然语言管理 n8n 工作流，连接 AI 助手与自动化平台。

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

分类: 开发工具第 315 / 438
Stars: ★ 547 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 6 个月前 ⚠
工具数: 15

44FMRS · D

根据提供的 README，该服务器是社区项目，非官方维护。它提供了全面的工具集，但安全性依赖于用户正确配置 API 密钥和网络访问。建议在生产环境中谨慎使用，并定期审查权限。

最强项 · 文档质量 13/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

7/20

维护活跃度

8/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 证据仅限于 README；未提供任何源代码、测试或 CI 工作流文件，且 server manifest 未缓存，无法将声称的 15 个工具与真实声明交叉核对。README 描述的 happy path（npx 启动、列示/获取/创建/执行等工具）看似合理，但没有可验证的执行证据，按静态校准规则可靠性不能超过 12，实际给到 5。扣分原因：缺少测试套件与 CI 配置、无法确认 MCP 初始化与工具列表握手、文档内部存在矛盾（如“零配置”与必须设置 N8N_HOST/N8N_API_KEY 冲突；两个小节都标为 Method 2）。
安全与权限 7/20: 凭据通过 N8N_API_KEY/N8N_HOST 环境变量传递，示例均为占位符，未发现真实密钥，也未触发任何红线（无恶意代码、无隐蔽外传、无真实令牌泄出、无未经确认的不可逆默认操作）。该服务器本质是用户提供 API key 并请求用户指定主机的 API 封装器，属于预期设计。但 README 推荐优先使用 Smithery 托管模式，意味着把 n8n API key 交给第三方；delete_workflow、delete_execution、deactivate_workflow 等破坏性工具未显示任何确认机制；n8n API key 的权限范围仅以“appropriate permissions”一笔带过，未展示服务端最小权限或作用域限制。由于无法查看源码，这些安全声明不可验证，故保守给 7 分。
维护活跃度 8/20: 仓库未归档、采用 MIT 许可，元数据显示 534 stars 与 5 个 open issues——但 star 仅是发现信号，不计分。本次未提供提交历史、发版节奏、依赖更新记录、问题响应时效或安全响应渠道等信息；README 中的 CI 徽章属于不可信的市场宣传材料。因为治理细节（谁在维护、如何发版、如何响应安全问题）无法从源代码层面验证，8 分属于保守估计。
文档质量 13/20: README 分层且高于平均水平：包含 Smithery/NPX/手动安装三种方式、环境变量表、Claude Desktop 与 Cline 的具体配置 JSON、声称的 15 个工具的参数表、按工具分组的用法示例、常见错误排查、FAQ，以及四个附加指南（GETTING_STARTED/USE_CASES/COMPARISON/TROUBLESHOOTING）。扣分点：“Zero Configuration”与必需环境变量自相矛盾；两个小节都标为“Method 2”，编号混乱；API key 所需具体权限和 n8n 接口速率/成本/限制未说明；未披露 MCP resources 与 capabilities；排障内容为通用描述，无法与代码核实。综合给 13 分。
安装易用性 11/20: 文档化的安装路径简短清晰：通过 npx 启动、设置两个环境变量、粘贴 README 提供的客户端配置即可，且有 Claude Desktop 与 Cline 的具体示例，属于少步骤、可操作性较强的路径。但静态校准规定：缺少真实 CI 工作流与提交的测试等可验证执行证据时，setup 最高 15 分；本次未提供任何此类证据。npm 包是否存在、npx 实际行为、Windows 路径细节、Node.js 18 检查等均无法验证；Smithery 托管路径虽增加一种选项，也引入第三方依赖。故给 11 分。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

使用 n8n 进行自动化并希望利用 AI 助手简化工作流管理的团队。
希望在不直接使用 n8n Web UI 的情况下，通过对话界面创建工作流的用户。
需要将 AI 助手集成到现有 n8n 工作流中的开发者。

不适合谁

没有 n8n 实例或 API 密钥的用户。
寻求完整低代码可视化界面而非 AI 驱动管理的用户。
需要与 n8n 官方产品团队直接支持或维护的用户。

所需权限

需要访问 n8n 实例的 URL（`N8N_HOST`）和 API 密钥（`N8N_API_KEY`）。
API 密钥应具有相应的权限，通常需要读写工作流、执行、标签和审计的权限。
服务器直接与你的 n8n 实例通信，不存储数据，但需要网络访问权限。

风险与副作用

API 密钥泄露可能导致未授权访问你的 n8n 工作流和数据。
错误配置可能导致工作流被意外修改、删除或执行。
涉及自动化操作时，应先在小范围测试。
依赖第三方托管服务（如 Smithery.ai）时，需注意数据隐私。

安装接入

准备工作

运行环境：Node.js 18+ · 远程托管（无需本地环境）

N8N_HOST 必填 n8n 实例的 URL（如 http://localhost:5678 或 https://your-n8n.com），由你自己部署或使用 n8n Cloud。

N8N_API_KEY 必填密钥 n8n 的 API 密钥，在 n8n 的 Settings → API Keys 中创建。

通过 Smithery.ai 使用托管版本（无需安装）或使用 NPX 本地运行：npx @makafeli/n8n-workflow-builder。
配置环境变量：N8N_HOST（你的 n8n 实例 URL）和 N8N_API_KEY（你的 n8n API 密钥）。
在你的 AI 助手的 MCP 配置中添加服务器。例如，对于 Claude Desktop，编辑 claude_desktop_config.json 并添加上述配置。

claude_desktop_config.json

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "@makafeli/n8n-workflow-builder"
      ],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "@makafeli/n8n-workflow-builder"
      ],
      "env": {
        "N8N_HOST": "http://localhost:5678",
        "N8N_API_KEY": "your-api-key-here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add n8n-workflow-builder -e N8N_HOST=http://localhost:5678 -e N8N_API_KEY=your-api-key-here -- npx @makafeli/n8n-workflow-builder

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 中添加配置并重启后，工具列表中应出现 list_workflows 等 15 个工具；输入"列出我的工作流"，如能返回 n8n 实例中的工作流即证明连接成功。

常见排障

连接拒绝（ECONNREFUSED）：检查 `N8N_HOST` 是否正确且 n8n 正在运行。
401 错误：验证 `N8N_API_KEY` 是否正确且未过期，并确保具有适当权限。
404 错误：使用 `list_workflows` 获取有效的工作流 ID。
服务器无法启动：确保 Node.js v18+ 已安装，并尝试 `npm cache clean --force`。
启用调试模式：`DEBUG=n8n-workflow-builder npx @makafeli/n8n-workflow-builder`。

试试这样问

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

列出我 n8n 实例中的所有工作流
创建一个带 Schedule Trigger 和 HTTP Request 节点的工作流并立即激活
显示最近 10 次执行失败的记录
为工作流创建一个名为 production 的标签

工具能力 15

list_workflows 只读

列出 n8n 实例中的所有工作流。

get_workflow 只读

获取特定工作流的详细信息。

create_workflow 写入

创建包含节点和连接的新工作流。

execute_workflow 写入

手动执行一个工作流。

update_workflow 写入

更新现有工作流的配置。

activate_workflow 写入

激活工作流以启用自动执行。

deactivate_workflow 写入

停用工作流以停止自动执行。

delete_workflow 破坏性

永久删除一个工作流。

展开其余 7 个工具

create_workflow_and_activate 写入

创建新工作流并立即激活。

list_executions 只读

列出工作流执行记录，支持过滤和分页。

get_execution 只读

获取特定执行记录的详细信息。

delete_execution 破坏性

删除工作流执行记录。

list_tags 只读

列出所有工作流标签。

create_tag 写入

创建新的工作流标签。

generate_audit 只读

生成综合安全审计报告。

使用场景

通过自然语言指令列出、浏览和管理 n8n 工作流。

自动创建复杂的工作流，根据描述生成节点和连接。

按需执行工作流，并监控执行状态。

批量更新或停用多个工作流。

管理工作流标签，进行组织和分类。

生成安全审计报告，用于合规性检查。

支持客户端

Claude Desktop

Cline

Continue

Other MCP-compatible clients

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

详细介绍

这个 MCP 服务器将 AI 助手（如 Claude Desktop、ChatGPT、Cline 等）直接连接到你的 n8n 实例，让你可以通过自然语言指令来创建、管理、执行和监控 n8n 工作流。它提供了一套全面的工具，涵盖了工作流的完整生命周期，包括创建、读取、更新、删除、激活/停用、执行、查看执行记录、管理标签以及生成安全审计报告。该服务器使用 n8n 的官方 API，并需要有效的 API 密钥进行认证。