/ 目录 / 演练场 / n8n-workflow-builder
● 社区 makafeli ⚡ 即开即用

n8n-workflow-builder

作者 makafeli · makafeli/n8n-workflow-builder

用自然语言构建并运行 n8n 工作流 —— 15 个工具覆盖创建/激活/执行和审计报告,支持连接自托管或云端 n8n。

n8n-workflow-builder (makafeli) 是一个 MCP,通过 REST API 与任何 n8n 实例通信。15 个工具覆盖完整工作流生命周期:列表、创建节点、激活、执行、更新、删除,以及执行历史和安全审计。

为什么要用

核心特性

实时演示

实际使用效果

n8n-workflow-builder.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "n8n-workflow-builder",
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "n8n-workflow-builder": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "n8n-workflow-builder"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: n8n-workflow-builder

从自然语言描述构建 n8n 工作流

👤 无代码 PM、独立创始人、内部运维 ⏱ ~20 min intermediate

何时使用: 你想要实现 webhook → Slack → Google Sheet 的流程,而无需手动拖拽节点。

前置条件
  • 运行中的 n8n 实例且已启用 API — docker run n8nio/n8n; 在环境变量中启用 N8N_API
  • API key — n8n 设置 → API Keys
步骤
  1. 描述流程
    创建一个 n8n 工作流:当 webhook 触发 /signup 时,将请求数据发送到 Slack #signups,并在 'Signups' 工作表中新增一行。✓ 已复制
    → 工作流已创建,3 个节点已连接
  2. 激活
    激活工作流并返回生产环境的 webhook URL。✓ 已复制
    → 已激活 + URL
  3. 冒烟测试
    用示例数据执行一次,然后拉取执行日志。✓ 已复制
    → 成功运行或可识别的失败

结果: 用几句提示就能实现自动化,不用在编辑器里花一上午。

注意事项
  • 新创建的节点上没有设置凭据 — MCP 无法为你创建密钥 —— 在 n8n UI 中添加一次 Slack/Google 凭据,然后按名称引用
搭配使用: google-sheets

从执行历史调试失败的 n8n 工作流

👤 维护自动化的运维工程师 ⏱ ~25 min intermediate

何时使用: 一个夜间工作流失败了,你想从聊天中排查问题。

步骤
  1. 拉取最近的失败
    查询工作流 'nightly-export' 最近 7 天内状态为 error 的执行记录。✓ 已复制
    → 包含日期和错误摘要的列表
  2. 检查最坏的一个
    获取最近一次失败的执行详情。显示我失败节点的输入和错误。✓ 已复制
    → 根本原因线索
  3. 修复并重新部署
    更新工作流以处理转换节点中的空值。然后停用 + 激活以重新加载。✓ 已复制
    → 后续运行成功

结果: 在无需打开编辑器的情况下解决了故障。

对你的 n8n 工作流运行安全审计

👤 安全 + 运维团队 ⏱ ~15 min intermediate

何时使用: 在上生产环境前或每季度,你想要一份合规风格的报告。

步骤
  1. 生成审计
    在我的 n8n 实例上使用 generate_audit。将发现的问题总结为:凭据、webhook 暴露和节点权限问题。✓ 已复制
    → 结构化审计报告
  2. 提交风险项目
    对于每个高严重性发现,在 Linear/GitHub 中创建一个包含修复方案的问题。✓ 已复制
    → 问题已创建

结果: 定期安全审查自动化。

组合

与其他 MCP 搭配,撬动十倍杠杆

n8n-workflow-builder + google-sheets

从聊天中构建和监控 webhook 到工作表的自动化

创建一个 n8n 工作流,将负载追加到我的 'Leads' 工作表;验证其端到端工作。✓ 已复制
n8n-workflow-builder + sentry

Sentry 告警 → n8n 工作流 → 事件响应链

当 Sentry 在项目 X 上看到峰值时,通过 execute_workflow 触发我的 n8n 工作流 'incident-page'。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
list_workflows 概览 1 API call
get_workflow id 检查节点 1 API call
create_workflow name, nodes[], connections 新自动化 1 API call
execute_workflow id, payload? 手动触发 / 测试 n8n CPU + downstream
activate_workflow id 部署到生产环境 1 API call
deactivate_workflow id 维护 / 回滚 1 API call
update_workflow id, changes 修复节点 1 API call
delete_workflow id 停用 1 API call
list_executions workflow_id?, status? 排查 1 API call
get_execution execution_id 根本原因 1 API call
generate_audit 安全审查 1 API call

成本与限制

运行它的成本

API 配额
n8n 本身没有 API 速率限制,除了你自己服务器的容量限制
每次调用 Token 数
工作流 JSON 可能很大 —— 复杂流程的 get_workflow 每次 2-10k 个 token
费用
自托管免费;n8n Cloud 按执行次数计费
提示
先使用 list_workflows,除非需要节点详情,否则避免在大型流程上使用 get_workflow

安全

权限、密钥、影响范围

凭据存储: N8N_API_KEY 在环境变量中 —— 授予完全 API 访问权限,据此限定范围
数据出站: 仅发送到你的 N8N_HOST

故障排查

常见错误与修复

401 Unauthorized

API key 错误或缺少权限 —— 在 n8n UI 中重新生成

验证: curl -H 'X-N8N-API-KEY: <key>' $N8N_HOST/api/v1/workflows
工作流已创建但执行失败

节点缺少凭据 —— 创建后在 UI 中附加它们;MCP 无法设置密钥

execute_workflow 挂起

长运行流程 —— 使用 activate + webhook 触发而不是同步执行

替代方案

n8n-workflow-builder 对比其他方案

替代方案何时用它替代权衡
直接 n8n REST API你在写脚本,而不是聊天你需要自己写接入代码
Zapier MCP你在使用 Zapier 而不是 n8n不同的生态系统;付费

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills