/ 目錄 / 演練場 / n8n-workflow-builder
● 社群 makafeli ⚡ 即開即用

n8n-workflow-builder

作者 makafeli · makafeli/n8n-workflow-builder

用自然語言建立並執行 n8n 工作流程 — 15 個工具涵蓋建立/啟用/執行以及稽核報告,可連接自架或雲端 n8n 實例。

n8n-workflow-builder (makafeli) 是一個透過 REST API 與任意 n8n 實例溝通的 MCP。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 流程,但不想拖拉節點。

前置條件
  • 已啟用 API 的 n8n 執行實例 — 執行 docker run n8nio/n8n;在環境變數中啟用 N8N_API
  • API 金鑰 — n8n 設定 → API Keys
步驟
  1. 描述流程
    建立一個 n8n 工作流程:當 webhook 收到 /signup 請求時,將 payload 發送到 Slack #signups 頻道,並在 'Signups' 試算表中新增一列。✓ 已複製
    → 已建立含 3 個節點並完成連線的工作流程
  2. 啟用
    啟用該工作流程並回傳正式環境的 webhook URL。✓ 已複製
    → 狀態為啟用並附上 URL
  3. 冒煙測試
    用範例 payload 執行一次,然後取得執行日誌。✓ 已複製
    → 執行成功或找出可辨識的錯誤

結果: 只需幾個提示就能完成自動化設定,而不必在編輯器裡花一個上午。

注意事項
  • 新建節點上尚未設定憑證 — MCP 無法替你建立密鑰 — 請在 n8n UI 中先新增一次 Slack/Google 憑證,之後透過名稱引用即可
搭配使用: google-sheets

透過執行歷史記錄對失敗的 n8n 工作流程進行除錯

👤 負責維護自動化流程的營運工程師 ⏱ ~25 min intermediate

何時使用: 某個每晚排程的工作流程持續失敗,你想直接在對話中進行問題分類。

步驟
  1. 取得近期失敗記錄
    列出工作流程 'nightly-export' 在過去 7 天內 status=error 的執行記錄。✓ 已複製
    → 含日期與錯誤摘要的列表
  2. 檢查最嚴重的一筆
    對最近一次失敗執行 get_execution,顯示失敗節點的輸入資料與錯誤訊息。✓ 已複製
    → 找出根本原因線索
  3. 修補並重新部署
    更新工作流程以處理 transform 節點中的 null 值,然後停用再啟用以重新載入。✓ 已複製
    → 後續執行成功

結果: 不需開啟編輯器即可解決服務中斷問題。

對你的 n8n 工作流程執行資安稽核

👤 資安與營運團隊 ⏱ ~15 min intermediate

何時使用: 在上線前或每季定期進行,需要一份合規風格的稽核報告。

步驟
  1. 產生稽核報告
    對我的 n8n 實例執行 generate_audit,並將結果整理為:憑證、webhook 暴露風險與節點權限問題三個類別。✓ 已複製
    → 結構化的稽核報告
  2. 建立高風險項目的工單
    針對每個高嚴重性發現,在 Linear/GitHub 中建立包含修復建議的 issue。✓ 已複製
    → Issues 已建立

結果: 將每季資安例行稽核自動化。

組合

與其他 MCP 搭配,撬動十倍槓桿

n8n-workflow-builder + google-sheets

在對話中建立並監控 webhook 到試算表的自動化流程

建立一個 n8n 工作流程,將 payload 附加到我的 '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 tokens
費用
自架免費;n8n Cloud 依執行次數計費
提示
優先使用 list_workflows 瀏覽概況,除非確實需要節點詳情,否則避免對大型流程呼叫 get_workflow

安全

權限、密鑰、影響範圍

憑證儲存:N8N_API_KEY 設定於環境變數中 — 此金鑰擁有完整 API 存取權,請依實際需求限縮範圍
資料出站: 僅傳輸至你的 N8N_HOST

故障排查

常見錯誤與修復

401 Unauthorized

API 金鑰錯誤或權限不足 — 請在 n8n UI 中重新產生金鑰

驗證: curl -H 'X-N8N-API-KEY: <key>' $N8N_HOST/api/v1/workflows
Workflow created but fails on execute

節點缺少憑證 — 請在建立後於 UI 中手動綁定;MCP 無法設定密鑰

execute_workflow hangs

流程執行時間過長 — 改用啟用工作流程並透過 webhook 觸發,而非同步執行

替代方案

n8n-workflow-builder 對比其他方案

替代方案何時用它替代權衡
Direct n8n REST API你是在撰寫腳本,而非透過對話操作需要自行撰寫所有串接程式碼
Zapier MCP你使用的是 Zapier 而非 n8n屬於不同生態系;需付費使用

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills